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
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
collection_address
Y
String
Collection's address
item_id
Y
String
Collection's item id
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
Metadata Content
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
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
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"
}Last updated