---
title: "list of collectibles with best order for each collectible, by default this only returns collectibles with an order"
method: POST
path: "/rpc/Marketplace/ListCollectibles"
tags: ["Marketplace"]
---

# list of collectibles with best order for each collectible, by default this only returns collectibles with an order

`POST /rpc/Marketplace/ListCollectibles`

## Request body

- MarketplaceListCollectiblesRequest
  - `side` 'unknown' | 'listing' | 'offer' — Represented as uint8 on the server side
  - `contractAddress` string
  - `filter` CollectiblesFilter
    - `includeEmpty` boolean, required
    - `searchText` string
    - `properties` PropertyFilter[] — []PropertyFilter
      - `name` string, required
      - `type` 'INT' | 'STRING' | 'ARRAY' | 'GENERIC', required — Represented as uint32 on the server side
      - `min` number
      - `max` number
      - `values` object[] — []any
    - `marketplaces` MarketplaceKind[] — []MarketplaceKind
    - `inAccounts` string[] — []string
    - `notInAccounts` string[] — []string
    - `ordersCreatedBy` string[] — []string
    - `ordersNotCreatedBy` string[] — []string
    - `inCurrencyAddresses` string[] — []string
    - `notInCurrencyAddresses` string[] — []string
  - `page` Page
    - `pageSize` number
    - `page` number
    - `more` boolean
    - `totalRecords` number
    - `column` string
    - `before` object
    - `after` object
    - `sort` SortBy[] — []SortBy
      - `column` string, required
      - `order` 'DESC' | 'ASC', required — Represented as uint32 on the server side

## Response `200`

OK

- MarketplaceListCollectiblesResponse
  - `collectibles` CollectibleOrder[] — []CollectibleOrder
    - `metadata` TokenMetadata, required
      - `tokenId` string, required
      - `name` string, required
      - `description` string
      - `image` string
      - `video` string
      - `audio` string
      - `properties` object — map<string,any>
      - `attributes` object[], required — []map<string,any>
      - `imageData` string
      - `externalUrl` string
      - `backgroundColor` string
      - `animationUrl` string
      - `decimals` number
      - `updatedAt` string
      - `assets` Asset[] — []Asset
        - `id` number, required
        - `collectionId` number, required
        - `tokenId` string
        - `url` string
        - `metadataField` string, required
        - `filename` string
        - `filesize` number
        - `mimeType` string
        - `width` number
        - `height` number
        - `updatedAt` string
      - `status` 'NOT_AVAILABLE' | 'STALE' | 'AVAILABLE', required — Represented as uint32 on the server side
      - `queuedAt` string
      - `lastFetched` string
    - `order` Order
      - `id` number, required
      - `collectionId` number, required
      - `collectibleId` number
      - `orderId` string, required
      - `marketplace` 'unknown' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2' | 'blur' | 'zerox' | 'opensea' | 'looks_rare' | 'x2y2' | 'alienswap' | 'payment_processor' | 'mintify' | 'magic_eden', required — Represented as uint8 on the server side
      - `source` 'unknown' | 'external' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2', required — Represented as uint32 on the server side
      - `side` 'unknown' | 'listing' | 'offer', required — Represented as uint8 on the server side
      - `status` 'unknown' | 'active' | 'inactive' | 'expired' | 'cancelled' | 'filled' | 'decimals_missing', required — Represented as uint8 on the server side
      - `chainId` number, required
      - `originName` string, required
      - `collectionContractAddress` string, required
      - `tokenId` string
      - `createdBy` string, required
      - `priceAmount` string, required
      - `priceAmountFormatted` string, required
      - `priceAmountNet` string, required
      - `priceAmountNetFormatted` string, required
      - `priceCurrencyAddress` string, required
      - `priceDecimals` number, required
      - `priceUSD` number, required
      - `priceUSDFormatted` string, required
      - `quantityInitial` string, required
      - `quantityInitialFormatted` string, required
      - `quantityRemaining` string, required
      - `quantityRemainingFormatted` string, required
      - `quantityAvailable` string, required
      - `quantityAvailableFormatted` string, required
      - `quantityDecimals` number, required
      - `feeBps` number, required
      - `feeBreakdown` FeeBreakdown[], required — []FeeBreakdown
        - `kind` string, required
        - `recipientAddress` string, required
        - `bps` number, required
      - `validFrom` string, required
      - `validUntil` string, required
      - `blockNumber` number, required
      - `orderCreatedAt` string
      - `orderUpdatedAt` string
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string
    - `listing` Order
      - `id` number, required
      - `collectionId` number, required
      - `collectibleId` number
      - `orderId` string, required
      - `marketplace` 'unknown' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2' | 'blur' | 'zerox' | 'opensea' | 'looks_rare' | 'x2y2' | 'alienswap' | 'payment_processor' | 'mintify' | 'magic_eden', required — Represented as uint8 on the server side
      - `source` 'unknown' | 'external' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2', required — Represented as uint32 on the server side
      - `side` 'unknown' | 'listing' | 'offer', required — Represented as uint8 on the server side
      - `status` 'unknown' | 'active' | 'inactive' | 'expired' | 'cancelled' | 'filled' | 'decimals_missing', required — Represented as uint8 on the server side
      - `chainId` number, required
      - `originName` string, required
      - `collectionContractAddress` string, required
      - `tokenId` string
      - `createdBy` string, required
      - `priceAmount` string, required
      - `priceAmountFormatted` string, required
      - `priceAmountNet` string, required
      - `priceAmountNetFormatted` string, required
      - `priceCurrencyAddress` string, required
      - `priceDecimals` number, required
      - `priceUSD` number, required
      - `priceUSDFormatted` string, required
      - `quantityInitial` string, required
      - `quantityInitialFormatted` string, required
      - `quantityRemaining` string, required
      - `quantityRemainingFormatted` string, required
      - `quantityAvailable` string, required
      - `quantityAvailableFormatted` string, required
      - `quantityDecimals` number, required
      - `feeBps` number, required
      - `feeBreakdown` FeeBreakdown[], required — []FeeBreakdown
        - `kind` string, required
        - `recipientAddress` string, required
        - `bps` number, required
      - `validFrom` string, required
      - `validUntil` string, required
      - `blockNumber` number, required
      - `orderCreatedAt` string
      - `orderUpdatedAt` string
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string
    - `offer` Order
      - `id` number, required
      - `collectionId` number, required
      - `collectibleId` number
      - `orderId` string, required
      - `marketplace` 'unknown' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2' | 'blur' | 'zerox' | 'opensea' | 'looks_rare' | 'x2y2' | 'alienswap' | 'payment_processor' | 'mintify' | 'magic_eden', required — Represented as uint8 on the server side
      - `source` 'unknown' | 'external' | 'sequence_marketplace_v1' | 'sequence_marketplace_v2', required — Represented as uint32 on the server side
      - `side` 'unknown' | 'listing' | 'offer', required — Represented as uint8 on the server side
      - `status` 'unknown' | 'active' | 'inactive' | 'expired' | 'cancelled' | 'filled' | 'decimals_missing', required — Represented as uint8 on the server side
      - `chainId` number, required
      - `originName` string, required
      - `collectionContractAddress` string, required
      - `tokenId` string
      - `createdBy` string, required
      - `priceAmount` string, required
      - `priceAmountFormatted` string, required
      - `priceAmountNet` string, required
      - `priceAmountNetFormatted` string, required
      - `priceCurrencyAddress` string, required
      - `priceDecimals` number, required
      - `priceUSD` number, required
      - `priceUSDFormatted` string, required
      - `quantityInitial` string, required
      - `quantityInitialFormatted` string, required
      - `quantityRemaining` string, required
      - `quantityRemainingFormatted` string, required
      - `quantityAvailable` string, required
      - `quantityAvailableFormatted` string, required
      - `quantityDecimals` number, required
      - `feeBps` number, required
      - `feeBreakdown` FeeBreakdown[], required — []FeeBreakdown
        - `kind` string, required
        - `recipientAddress` string, required
        - `bps` number, required
      - `validFrom` string, required
      - `validUntil` string, required
      - `blockNumber` number, required
      - `orderCreatedAt` string
      - `orderUpdatedAt` string
      - `createdAt` string, required
      - `updatedAt` string, required
      - `deletedAt` string
  - `page` Page
    - `pageSize` number
    - `page` number
    - `more` boolean
    - `totalRecords` number
    - `column` string
    - `before` object
    - `after` object
    - `sort` SortBy[] — []SortBy
      - `column` string, required
      - `order` 'DESC' | 'ASC', required — Represented as uint32 on the server side

## Other responses

- `4XX` — Client error
- `5XX` — Server error

---

[API](https://skmtc.dev/sequence/apis/analytics-api.md) · [All operations](https://skmtc.dev/sequence/apis/analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequence/analytics-api/revisions/12db1459a050/schema)