Query item metadata by chain name, collection address and item id

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/nft/get_nft_metadata

• Description: Query item metadata

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
collection_address	Y	String	Collection's address
item_id	Y	String	Collection's item id

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

Metadata Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain's name
collection_address	Y	String	Collection's address
item_id	Y	String	The item ID of the NFT in Number
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	Token's amount
mint_block	Y	Long	The block height when the NFT was minted
last_metadata_sync	Y	Long	When the metadata was last updated
last_token_uri_sync	Y	Long	When the token_uri was last updated
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 metada
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	Item's arrtributes

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/nft/get_nft_metadata?chain_name=eth&collection_address=0x932261f9fc8da46c4a22e31b45c4de60623848bf&item_id=126891"

Successful Response Sample

{
    "success": true,
    "data": {
        "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
    },
    "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"
}