Query item info list by chain name and collection address

Description

• Method: HTTPS GET

• Encoding: UTF-8

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

• Description: Query collection item info list

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. Enumeration
page	Y	Integer	Page number
page_size	Y	Integer	Page size(minimum:1 ,maximum:100)

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	N	List	Paginated list
pagination	N	Object	Page info

Pagination Content

Parameter	Required	Type	Description
current	Y	String	Current page number
page_size	Y	Integer	Current page size
total	Y	Integer	Total number
count_page	Y	Integer	Total page number

CollectionItem Content

Parameter	Required	Type	Description
collection_address	Y	String	Collection's address
collection_name	N	String	Collection's name
symbol	N	String	Collection's symbol
item_id	Y	String	The item id of the NFT in Number
name	N	String	Collection's item name
description	N	String	Description
item_url	N	String	URL of the item metadata
minter	N	String	The user address who minted the item
mint_block_height	N	Long	The block height when the NFT was minted
mint_block_time	N	Long	The block time when the NFT was minted
image	N	String	Item's image url
animation	N	String	Animation url
external_url	N	String	External image url
amount	N	String	The amount of item
attributes	N	List	List of attributes
last_metadata_sync	N	Long	When the metadata was last updated at

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/collection/item_list?address=0x0ffce51b969c4aab7ce078ba7127385ac5939204&page=1&page_size=10&chain_name=Ethereum"

Successful Response Sample

{
    "success": true,
    "data": {
        "list": [
            {
                "collection_address": "0x0ffce51b969c4aab7ce078ba7127385ac5939204",
                "collection_name": "Pepe Millionaires",
                "symbol": "PEPEMIL",
                "item_id": "321",
                "name": "Pepe Millionaires #321",
                "description": null,
                "item_url": "ipfs://bafybeiga3vv4ly6xnm7uxjqmjokwp47lxryeubcbr7p3a7q7jnvdhtyfde/321",
                "minter": "0xb798e1944d57dac59da1ddd833506f49967dd6f3",
                "mint_block_height": 17471588,
                "mint_block_time": 1686665567,
                "image": "https://ipfs.io/ipfs/bafybeigkfchr45s2ih2k5jh2p6p2nhtcouvshivokf6udatcbx3ozejkum/321.png",
                "animation": null,
                "external_url": "https://ipfs.io/ipfs/bafybeigkfchr45s2ih2k5jh2p6p2nhtcouvshivokf6udatcbx3ozejkum/321.png",
                "amount": "1",
                "attributes": [
                    {
                        "value": "Aquamarine",
                        "trait_type": "Background"
                    },
                    {
                        "value": "Pepe",
                        "trait_type": "Body"
                    },
                    {
                        "value": "Pepe T-shirt Red",
                        "trait_type": "Clothes"
                    },
                    {
                        "value": "Closed",
                        "trait_type": "Eyes"
                    },
                    {
                        "value": "Lincoln",
                        "trait_type": "Head"
                    },
                    {
                        "value": "Happy",
                        "trait_type": "Mouth"
                    }
                ],
                "last_metadata_sync": 1687459246
            }
        ],
        "pagination": {
            "current": 3,
            "page_size": 1,
            "total": 3,
            "count_page": 3
        }
    },
    "error_code": null,
    "error_msg": null
}

Failed Response Sample

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