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

Parameter	Required	Type	Description
Content-Type	Y	String	application/json
AccessKey	Y	String	1bdb01c947c54919b64d1fc6794atest

Request Parameters

Parameter	Required	Type	Description
chain_name	Y	String	Chain's name,support single chain's name.eg:eth,Ethereum. Enumeration
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

Parameter	Required	Type	Description
success	Y	Boolean	Success Boolean
data	N	Object	Response object
error_code	N	String	Error code
error_msg	N	String	Error message

Response Content

Parameter	Required	Type	Description
list	Y	List	Paginated list
pagination	Y	Object	Page info

Pagination Content

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
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"
}