查询 NFT 资产#

查询指定钱包下全部链或某条链的 NFT 资产，或某个指定的 NFT 资产。

请求地址#

POST https://www.okx.com/api/v5/waas/asset/get-nft-assets

请求参数#

Parameter	Type	Required	Description
walletId	String	Yes	钱包唯一标识
chainIds	Array<String>	No	链唯一标识列表 (如有，且没有 tokenContractAddress 维度的，则按 chainId 维度查询)
tokenContractAddress	Array<String>	No	项目合集的合约地址信息 (如有，则按 NFT 合约地址维度查询)
limit	String	No	每页查询多少，默认值为 20
cursor	String	No	查询游标，默认为第一页

响应参数#

Parameter	Type	Description
nftAssetsList	Array<Object>	NFT 资产数组
cursor	String	查询游标

nftAssetsList (NFT 资产)

Parameter	Type	Description
name	String	NFT 的名称
tokenId	String	NFT 代币的唯一标识
tokenUri	String	NFT 的元数据地址
image	String	NFT 的图片地址
imagePreviewUrl	String	NFT 的图片预览图地址
imageThumbnailUrl	String	NFT 的图片缩略图地址
animationUrl	String	NFT 的音视频资源地址
attributes	String	NFT 的特殊属性信息，一个属性模型
assetContract	Object	合约信息，一个合约信息模型对象
collection	Object	合集信息，一个合集模型对象
ownerAddress	String	资产所有者的地址
isLazyMintType	Boolean	是否为延迟铸币并且未发生转移

Attributes (Array. StringObject)

Parameter	Type	Description
trait_type	String	特殊属性的名称 (比如颜色)
value	String	特殊属性的值 (可能是字符串，也可能是数值)
display_type	String	特殊属性应该如何展示 (可选项可能是数字、百分比、百分比数据、日期等)

assetContract

Parameter	Type	Description
chain	String	与该合集相关的合约所属链
contractAddress	String	与该合集相关的合约地址
tokenStandard	String	该合约对应的协议类型，例如 ERC-721、ERC-1155
ownerAddress	String	该合约对应的拥有者地址
erc2981	Boolean	该合约是否支持 ERC-2981 协议

collection

Parameter	Type	Description
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	合集分类标签列表
stats	Object	该合集对应统计数据，包括交易额、地板价等，一个合集统计信息模型对象

stats

Parameter	Type	Description
latestPrice	String	该合集的最新成交价格
totalVolume	String	该合集的总交易额
totalCount	String	该合集的 NFT 数量
ownerCount	String	该合集的拥有者数量
floorPrice	String	该合集的地板价

请求示例#

shell

curl --location --request POST 'https://www.okx.com/api/v5/waas/asset/get-assets' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
--data-raw '{
  "walletId":"13886e05-1265-4b79-8ac3-b7ab46211002",
  "chainIds":["1"],
  "limit": 1,
  "cursor":"Nzg0MjE3MTI1MDMyMDc="
}'

响应示例#

200

{
  "code": "0",
  "msg": "success",
  "data": [{
    "cursor": "MTMyMTY3MDU4MjgxNDM5",
    "nftAssetsList": [{
      "tokenId": "1165534",
      "name": "Bag #1165534",
      "attributes": [],
      "image": "https://static.coinall.ltd/cdn/nft/files/89e9616d-1e3c-4d82-8e68-abb82edd59b2.svg",
      "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/89e9616d-1e3c-4d82-8e68-abb82edd59b2.svg",
      "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/89e9616d-1e3c-4d82-8e68-abb82edd59b2.svg",
      "tokenUri": null,
      "animationUrl": "https://static.coinall.ltd/cdn/nft/files/89e9616d-1e3c-4d82-8e68-abb82edd59b2.svg",
      "assetContract": {
        "chain": "Ethereum",
        "contractAddress": "0x1dfe7ca09e99d10835bf73044a23b73fc20623df",
        "tokenStandard": "erc721",
        "ownerAddress": "0xf296178d553c8ec21a2fbd2c5dda8ca9ac905a00",
        "erc2981": false
      },
      "collection": {
        "stats": {
          "latestPrice": 75841.6,
          "totalVolume": 1.777921917306267E9,
          "totalCount": 135463,
          "ownerCount": 25301,
          "floorPrice": 3.7489
        },
        "name": "More Loot",
        "des": "Welcome to the home of More Loot on OKX. Discover the best items in this collection.",
        "image": "",
        "backgroundImage": "",
        "slug": "more-loot",
        "certificateFlag": false,
        "officialWebsite": "",
        "twitterUrl": "",
        "instagramUrl": "",
        "discordUrl": "",
        "mediumUrl": "",
        "categoryList": []
      },
      "isLazyMintType": false,
      "ownerAddress": "0xf4c549028f6947669a8bc71719415ab056ce81c8"
    }]
  }]
}