获取资产列表#
该接口用于获取资产所有人在指定链下持有的 NFT 资产列表，列表包括NFT详细信息，包括基础信息、合约信息和统计信息，例如地板价。
请求地址#
GET https://web3.okx.com/api/v5/mktplace/nft/owner/asset-list
请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| chain | String | 是 | 链名称，详情见已支持的网络 |
| contractAddress | String | 否 | 合约地址，必须是一个有效的合约地址 |
| ownerAddress | String | 是 | 资产所有者的地址，必须是一个有效的所有者地址 |
| cursor | String | 否 | 指向要检索的页面的游标 |
| limit | String | 否 | 分页大小（默认值 10，最大 100）。返回最大的合集数 |
响应参数#
一个资产模型的对象数组
| 参数 | 类型 | 描述 |
|---|---|---|
| name | String | NFT 的名称 |
| tokenId | String | NFT 的 token ID |
| amount | String | 指定 tokenId 下 NFT 的总供应量 |
| tokenUri | String | NFT 的元数据地址 |
| image | String | NFT 的图片地址 |
| imagePreviewUrl | String | NFT 的图片预览图地址 |
| imageThumbnailUrl | String | NFT 的图片缩略图地址 |
| animationUrl | String | NFT 的音视频资源地址 |
| attributes | Object | NFT 的特殊属性信息，一个属性模型 |
| assetContracts | Object | 合约信息，一个合约信息模型对象 |
| collection | Object | 合集信息，一个合集模型对象 |
| ownerAddress | String | 资产所有者的地址 |
| isLazyMintType | Boolean | 是否为延迟铸币并且未发生转移 |
请求示例#
shell
curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/owner/asset-list" \
-H 'OK-ACCESS-KEY: XXX' \
-H 'OK-ACCESS-TIMESTAMP: XXX' \
-H 'OK-ACCESS-PASSPHRASE: XXX' \
-H 'OK-ACCESS-SIGN: XXX' \
-d "contractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d" \
-d "ownerAddress=0x46efbaedc92067e6d60e84ed6395099723252496" \
-d "limit=1"
响应示例#
200
{
"code": 0,
"data": {
"cursor": "MzQ2MDQ4Mg==",
"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": "83119.7",
"latestPrice": "104451.04",
"ownerCount": "5703",
"totalCount": "10000",
"totalVolume": "2304507531.1537676"
},
"twitterUrl": "https://twitter.com/BoredApeYC"
},
"image": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp",
"imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp/type=list",
"imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp/type=detail",
"isLazyMintType": false,
"name": "Bored Ape Yacht Club #1",
"ownerAddress": "0x46efbaedc92067e6d60e84ed6395099723252496",
"tokenId": "1",
"tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"
}
]
},
"msg": ""
}