Query items by chain name, collection address and user address
Description
Method: HTTPS GET
Encoding: UTF-8
Path: https://api.blockin.ai/v2/user/nft/wallet_item_list
Description: Query items by chain name, collection address and user address
Request Header
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
address
Y
String
Holder's address
collection_addresses
N
Array
Collection's addresses
page
Y
Integer
Page number
page_size
Y
Integer
Page size
Response
Public Response
success
Y
Boolean
Success Boolean
data
N
Object
Response object
error_code
N
String
Error code
error_msg
N
String
Error message
Response Content
list
Y
List
Paginated list
pagination
Y
Object
Page info
Pagination Content
current
Y
Integer
Current page number
page_size
Y
Integer
Current page size
total
Y
Integer
Total number
count_page
Y
Integer
Total page number
HolderItem Content
chain_name
Y
String
Chain's name
collection_address
Y
String
Collection's address
item_id
Y
String
Collection's item id
name
Y
String
Collection's name
symbol
Y
String
Collection's symbol
contract_type
Y
String
The standard of the NFT (721, 1155)
holder_address
Y
String
The wallet address of the holder of the NFT
block_height
Y
Long
The block height when the amount or holder changed
amount
Y
String
The amount of NFT items held by the user
mint_block
Y
Long
The block height when the NFT was minted
last_metadata_sync
Y
Long
When the metadata was last updated at
last_token_uri_sync
Y
Long
When the token_uri was last updated at
item_metadata
Y
ItemMetadata
Item's metadata
ItemMetadata Content
item_name
Y
String
Item's name
description
Y
String
The description of the item
item_url
Y
String
URL of the item metadata
image
Y
String
URL of the item image
animation_url
Y
String
URL of the item metadata animation
external_url
Y
String
A link to additional information
attributes
Y
List
List of attributes
Attribute Content
trait_type
Y
String
Item's trait type
value
Y
String
Trait value
Request Sample
curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/nft/wallet_item_list?chain_name=eth&address=0xb0642076a64b270176cb92f73f4786daccc7d776&collection_addresses=0x932261f9fc8da46c4a22e31b45c4de60623848bf,0x0000000000664ceffed39244a8312bd895470803&page=1&page_size=10"
Successful Response Sample
{
"success": true,
"data": {
"list": [
{
"chain_name": "Ethereum",
"collection_address": "0x932261f9fc8da46c4a22e31b45c4de60623848bf",
"amount": "1",
"mint_block": 17510075,
"last_metadata_sync": 1687107453,
"last_token_uri_sync": 1687107453,
"name": "Zerion DNA 1.0",
"symbol": "DNA",
"contract_type": "ERC721",
"item_metadata": {
"description": "Zerion DNA is a first of a kind Dynamic NFT Avatar – a generative, living NFT that evolves over time to reflect your digital identity. Every wallet action renders unique attributes so that no two NFTs are alike. Wallet actions that will cause the NFT to evolve include buying and selling tokens, interacting with different networks and exploring the Zerion app.\n\nTo claim your DNA, create a Zerion Wallet via our Zerion iOS and Android apps.",
"image": "https://zerion-dna.s3.us-east-1.amazonaws.com/onepointo/6b4635cd5a4ab32f1e3e66afc38815cdb2816e07.png",
"external_url": null,
"attributes": [
{
"value": "Yes",
"trait_type": "Primary"
},
{
"value": "0 weeks",
"trait_type": "Age"
},
{
"value": "$0–$50",
"trait_type": "Gas Spend"
},
{
"value": "0",
"trait_type": "Transactions"
},
{
"value": "$0–$100",
"trait_type": "Balance"
},
{
"value": "0",
"trait_type": "Assets"
},
{
"value": "-",
"trait_type": "Favorite Network"
},
{
"value": "Yes",
"trait_type": "Enabled"
},
{
"value": "Level 1",
"trait_type": "Body"
}
],
"item_name": "#126891",
"item_url": "https://dna.zerion.io/api/v1/avatars/onepointo/126891",
"animation_url": null
},
"item_id": "126891",
"holder_address": "0xb0642076a64b270176cb92f73f4786daccc7d776",
"block_height": 17510075
},
{
"chain_name": "Ethereum",
"collection_address": "0x0000000000664ceffed39244a8312bd895470803",
"amount": "1",
"mint_block": 17477642,
"last_metadata_sync": 1687471921,
"last_token_uri_sync": 1687471921,
"name": "mint.fun !fundrop pass",
"symbol": "FUNPASS",
"contract_type": "ERC721",
"item_metadata": {
"description": "This !fundrop pass is a non-transferable NFT that allows the holder to participate in !fundrop and get !fun rewards for minting NFTs. Mint your own !fundrop pass at https://mint.fun/fundrop.",
"image": "https://media.contextcdn.com/fd-meta-square.png",
"external_url": null,
"attributes": null,
"item_name": "!fundrop pass",
"item_url": "https://mint.fun/api/mintfun/fundrop/token/225888.json",
"animation_url": null
},
"item_id": "225888",
"holder_address": "0xb0642076a64b270176cb92f73f4786daccc7d776",
"block_height": 17477642
}
],
"pagination": {
"current": 1,
"page_size": 10,
"total": 2,
"count_page": 1
}
},
"error_code": null,
"error_msg": null
}
Failed Response Sample
{
"success": false,
"data": null,
"error_code": "CHAIN_NOT_SUPPORT",
"error_msg": "The current chain is not supported temporarily"
}Last updated