获取合集列表#

该接口用来获取欧易平台上的合集列表。

要获取指定链的合集列表，请设置请求参数中的链名称 chain 字段。

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/collection/list

请求参数#

参数	类型	必传	描述
chain	String	否	链名称，详情见已支持的网络
cursor	String	否	指向要检索的页面的游标
limit	String	否	分页大小（默认值 300，最大 300）。返回最大的合集数

响应参数#

一个合集模型的对象数组

参数	类型	说明
name	String	合集名称
des	String	合集简介
image	String	合集头像图片地址
backgroundImage	String	合集背景图片地址
slug	String	合集 slug 名称，即合集的唯一标识
certificateFlag	Boolean	合集认证标记
officialWebsite	String	合集官网地址
instagramUrl	String	合集 Instagram 地址
discordUrl	String	合集 Discord 地址
mediumUrl	String	合集 Medium 地址
twitterUrl	String	合集推特地址
categoryList	Array	合集分类标签列表
assetContracts	Array	与该合集相关的合约信息列表，包括合约地址，协议标准，拥有者地址，是否支持 erc2981 协议等，一个合约信息模型数组
stats	Object	该合集对应统计数据，包括交易额、地板价等，一个合集统计信息模型对象

请求示例#

shell

curl -X GET "https://www.okx.com/api/v5/mktplace/nft/collection/detail" \
  -H 'OK-ACCESS-KEY: XXX' \
  -H 'OK-ACCESS-TIMESTAMP: XXX' \
  -H 'OK-ACCESS-PASSPHRASE: XXX' \
  -H 'OK-ACCESS-SIGN: XXX' \
  -d "chain=eth" \
  -d "limit=1"

响应示例#

200

{
  "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": "https://static.coinall.ltd/cdn/nft/files/collection/205-background.png",
    "categoryList": [
      "Collectibles"
    ],
    "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 www.BoredApeYachtClub.com for more details.",
    "discordUrl": "https://discord.gg/3P5K3dzgdB",
    "image": "https://static.coinall.ltd/cdn/nft/d962ef0d-1cc1-4333-b19f-fc19c7322335.jpg",
    "instagramUrl": "",
    "mediumUrl": "",
    "name": "Bored Ape Yacht Club",
    "officialWebsite": "http://www.boredapeyachtclub.com/",
    "slug": "bored-ape-yacht-club",
    "stats": {
      "floorPrice": "105752.05",
      "latestPrice": "102662.45",
      "ownerCount": "5666",
      "totalCount": "10000",
      "totalVolume": "2239291136.375853"
    },
    "twitterUrl": "https://twitter.com/BoredApeYC"
    },
    "image": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp",
    "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=list",
    "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=detail",
    "name": "Bored Ape Yacht Club #11",
    "tokenId": "11",
    "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/11"
  }
  ],
  "msg": ""
}