获取 NFT 列表#

该接口用来获取欧易平台上特定链和合约地址下的 NFT 列表。

请求地址#

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

请求参数#

参数	类型	必传	描述
chain	String	是	链名称，详情见已支持的网络
contractAddress	String	是	合约地址，必须是一个有效的合约地址
cursor	String	否	指向要检索的页面的游标
limit	String	否	分页大小（默认值 300，最大 300）

响应参数#

一个 NFT 模型的对象数组

参数	类型	描述
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/list" \
  -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"

响应示例#

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": ""
}