Query collection metadata by chain name and collection address

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/nft/collection/metadata

• Description: Query collection base information

Request Header

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

Request Parameters

Parameter	Required	Type	Description
address	Y	String	Collection's address
chain_name	Y	String	eg : eth,Ethereum,pol,Polygon. Enumeration

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
collection_name	N	String	Collection's name （opensea）
collection_address	Y	String	Collection's address
name	N	String	Collection's name
symbol	N	String	Collection's symbol
supply	N	String	Supply
contract_type	N	String	The standard of the NFT (721, 1155)
deployer	N	String	Deployer address
deploy_block_height	N	Long	The block height when the Collection was deployed
deploy_block_time	N	Long	The block time when the collection was deployed
description	N	String	Description
logo_url	N	String	URL of the collection's logo image
banner_url	N	String	Banner url
site_url	N	String	Website URL
twitter	N	String	The twitter
instagram	N	String	The instagram
telegram	N	Long	The telegram
discord	N	String	The discord

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/nft/collection/metadata?address=0xdb691c32c75aa9c9c44a6b7ec94195a50716d2ec&chain_name=Ethereum"

Successful Response Sample

{
    "success": true,
    "data": {
        "collection_name": "Thicc Frens Genesis",
        "collection_address": "0xdb691c32c75aa9c9c44a6b7ec94195a50716d2ec",
        "name": "Thicc Frens",
        "symbol": "THICCFRENS",
        "supply": "10000",
        "contract_type": "ERC721",
        "deployer": "0xdb691c32c75aa9c9c44a6b7ec94195a50716d2ec",
        "deploy_block_height": 10000001,
        "deploy_block_time": 1651794615303,
        "description": "5,555 sassy thicc dogs will help you get thicc through daily staking rewards, true companions for your metaverse journey. These cheeky NFTs come in 30 different breeds, all of which have well endowed thicc butts. There are over 300 unique attributes including hats, hair, accessories, mouths, eyes, backgrounds and more. Each dog has a rarity value that determines how much $THICC token it'll earn per day when staked (Common, Uncommon and Rare). Adopt a thicc fren and start earning $THICC today!\n\nPresale Mint 1 - May 8th, 2022 -----\nPresale Mint 2 - May 18th, 2022 -----\nFree Mint - May 31st, 2022 -----",
        "logo_url": "https://i.seadn.io/gae/zpY-zSAgIXTJpX3LadtSufiVYujxNbb5Za8bzCinqYjU-ayzUgCo30CpnCEWUq4FZTuIsmPXEQ073sbZr3WnMywVnMAeqxHT2CMI?w=500&auto=format",
        "banner_url": "https://i.seadn.io/gae/c64yfutaB8FgV_e_mvFl-jlOjgQrfQMZPgQ4j-hn16L9CFAVCgbnIxk2Aq1ad_NpB6XeGlRZOcXJcpk9LoAdcwikrrYHXNUcWY5u7w?w=500&auto=format",
        "site_url": "https://thiccfrens.com/",
        "twitter": "https://twitter.com/ThiccFrens",
        "instagram": "https://www.instagram.com/thiccfrens",
        "telegram": "https://t.me/ThiccFrens",
        "discord": "https://discord.gg/thicc-frens"
    },
    "error_code": null,
    "error_msg": null
}

Failed Response Sample

{
    "success": false,
    "data": null,
    "error_code": "INVALID_PARAM",
    "error_msg": "Invalid chain"
}