市场 API

获取合集详情#

该接口用于获取单个合集的详细信息,包括基础信息、合约信息和统计信息,例如地板价。

请求地址#

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

请求参数#

参数类型必传描述
slugString合集 slug 名称,即合集的唯一标识

响应参数#

参数类型描述
nameString合集名称
desString合集简介
imageString合集头像图片地址
backgroundImageString合集背景图片地址
slugString合集 slug 名称,即合集的唯一标识
certificateFlagBoolean合集认证标记
officialWebsiteString合集官网地址
instagramUrlString合集 Instagram 地址
discordUrlString合集 Discord 地址
mediumUrlString合集 Medium 地址
twitterUrlString合集推特地址
categoryListArray合集分类标签列表
assetContractsArray与该合集相关的合约信息列表,包括合约地址,协议标准,拥有者地址,是否支持 erc2981 协议等,一个合约信息模型数组
statsObject该合集对应统计数据,包括交易额、地板价等,一个合集统计信息模型对象

请求示例#

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 "slug=xxx" \

响应示例#

200
{
  "code": 0,
  "data": {
    "cursor": "NA==",
    "data": [
      {
        "assetContracts": [
          {
            "chain": "Ethereum",
            "contractAddress": "0xff9c1b15b16263c61d017ee9f65c50e4ae0113d7",
            "erc2981": false,
            "ownerAddress": "0xf296178d553c8ec21a2fbd2c5dda8ca9ac905a00",
            "tokenStandard": "erc721"
          }
        ],
        "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/8000-background.png",
        "categoryList": [],
        "certificateFlag": true,
        "des": "Loot is randomized adventurer gear generated and stored on chain. Stats, images, and other functionality are intentionally omitted for others to interpret. Feel free to use Loot in any way you want.",
        "discordUrl": "",
        "image": "https://static.coinall.ltd/cdn/nft/78d10ba9-63fc-4104-a13c-73e51ac2acb6.jpg",
        "instagramUrl": "",
        "mediumUrl": "",
        "name": "Loot (for Adventurers)",
        "officialWebsite": "https://lootproject.com",
        "slug": "loot-for-adventurers",
        "stats": {
          "floorPrice": "866.74799",
          "latestPrice": "616.4433",
          "ownerCount": "2522",
          "totalCount": "7779",
          "totalVolume": "552505219.5371664"
        },
        "twitterUrl": ""
      }
    ]
  },
  "msg": ""
}