Marketplace API
Retrieve collection list

Retrieve collection list#

This interface provides a list of all the collections supported and vetted by OKX.

To get the collection list of the specified chain, set the chain field in the request parameter.

Request address#


Request param#

chainStringNoChain name refer to Supported blockchains for details
cursorStringNoFor pagination; a cursor pointing to the page to retrieve
limitStringNoFor pagination; the maximum number of collections to return; the default value is 2, and the max is 300

Response param#

Array of objects of the collection model

nameStringCollection name
desStringCollection description
imageStringCollection logo URL
backgroundImageStringCollection background image URL
slugStringCollection slug, which is the unique identifier of the collection
certificateFlagBooleanCollection certification flag
officialWebsiteStringCollection official website
instagramUrlStringThe Instagram URL of the collection
discordUrlStringThe Discord URL of the collection
mediumUrlStringThe Medium URL of the collection
twitterUrlStringThe Twitter URL of the collection
categoryListArrayThe category list of the collection
assetContractsArrayAn array of the asset contract model that are associated with this collection, including contract address, protocol standard, owner address, whether the ERC-2981 protocol is supported, etc.
statsObjectA dictionary containing some statistics related to this collection, including trade volume and floor prices, an object of the collection stats model

Request example#

curl -X GET "" \
  -d "chain=eth" \
  -d "limit=1"

Response example#

  "code": 0,
  "data": [
  "animationUrl": "",
  "assetContract": {
  "chain": "Ethereum",
  "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "erc2981": false,
  "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
  "tokenStandard": "erc721"
  "attributes": "[{\"trait_type\":\"Background\",\"value\":\"Gray\"},{\"trait_type\":\"Fur\",\"value\":\"Dark Brown\"},{\"trait_type\":\"Hat\",\"value\":\"Laurel Wreath\"},{\"trait_type\":\"Mouth\",\"value\":\"Bored Unshaven Cigarette\"},{\"trait_type\":\"Clothes\",\"value\":\"Smoking Jacket\"},{\"trait_type\":\"Eyes\",\"value\":\"Bloodshot\"}]",
  "collection": {
  "assetContracts": [
  "chain": "Ethereum",
  "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "erc2981": false,
  "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
  "tokenStandard": "erc721"
  "backgroundImage": "",
  "categoryList": [
  "certificateFlag": true,
  "des": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit for more details.",
  "discordUrl": "",
  "image": "",
  "instagramUrl": "",
  "mediumUrl": "",
  "name": "Bored Ape Yacht Club",
  "officialWebsite": "",
  "slug": "bored-ape-yacht-club",
  "stats": {
  "floorPrice": "105752.05",
  "latestPrice": "102662.45",
  "ownerCount": "5666",
  "totalCount": "10000",
  "totalVolume": "2239291136.375853"
  "twitterUrl": ""
  "image": "",
  "imagePreviewUrl": "",
  "imageThumbnailUrl": "",
  "name": "Bored Ape Yacht Club #11",
  "tokenId": "11",
  "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/11"
  "msg": ""