查询指定钱包下全部链或某条链的 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 | 该合集的地板价 |
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="
}'
{
"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"
}]
}]
}