获取资产列表#

该接口用于获取资产所有人在指定链下持有的 NFT 资产列表，列表包括NFT详细信息，包括基础信息、合约信息和统计信息，例如地板价。

请求地址#

GET https://www.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://www.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": ""
}