获取 NFT 详情#

该接口可以用来获取 token 详情，合集信息，合约信息，以及 token 的特殊属性等。

请求地址#

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

请求参数#

参数	类型	必传	描述
chain	String	是	链名称，详情见已支持的网络
contractAddress	String	是	合约地址，必须是一个有效的合约地址
tokenId	String	是	NFT 的 tokenId

响应参数#

参数	类型	描述
name	String	NFT 的名称
tokenId	String	NFT 的 token ID
tokenUri	String	NFT 的元数据地址
image	String	NFT 的图片地址
imagePreviewUrl	String	NFT 的图片预览图地址
imageThumbnailUrl	String	NFT 的图片缩略图地址
animationUrl	String	NFT 的音视频资源地址
attributes	Object	NFT 的特殊属性信息，一个属性模型
assetContracts	Object	合约信息，一个合约信息模型对象
collection	Object	合集信息，一个合集模型对象

请求示例#

shell

curl -X GET "https://www.okx.com/api/v5/mktplace/nft/asset/detail" \
  -H 'OK-ACCESS-KEY: XXX' \
  -H 'OK-ACCESS-TIMESTAMP: XXX' \
  -H 'OK-ACCESS-PASSPHRASE: XXX' \
  -H 'OK-ACCESS-SIGN: XXX' \
  -d "chain=xxx" \
  -d "contractAddress=xxx" \
  -d "tokenId=xxx"

响应示例#

200

{
  "code": 0,
  "data": {
    "animationUrl": "",
    "assetContract": {
      "chain": "Ethereum",
      "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
      "erc2981": false,
      "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
      "tokenStandard": "erc721"
    },
    "attributes": "[{\"trait_type\":\"Mouth\",\"value\":\"Grin\"},{\"trait_type\":\"Clothes\",\"value\":\"Vietnam Jacket\"},{\"trait_type\":\"Background\",\"value\":\"Orange\"},{\"trait_type\":\"Eyes\",\"value\":\"Blue Beams\"},{\"trait_type\":\"Fur\",\"value\":\"Robot\"}]",
    "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/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp",
    "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp/type=list",
    "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp/type=detail",
    "name": "Bored Ape Yacht Club #1",
    "tokenId": "1",
    "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"
  },
  "msg": ""
}