Query collections by chain name and user address

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https: https://api.blockin.ai/v2/user/nft/wallet_collection_list

• Description: Query collections by chain name 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
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

HolderCollection Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain's name
collection_address	Y	String	Collection's address
amount	Y	String	The amount of NFT items held by the user
name	Y	String	Collection's name
logo_url	Y	String	Url of the collection's logo image
symbol	Y	String	Collection's symbol
contract_type	Y	String	The standard of the NFT (721, 1155)

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/nft/wallet_collection_list?chain_name=eth&address=0x996e1d4ce3e1e558889832832004b2466153adbe&page=1&page_size=10"

Successful Response Sample

{
    "success":true,
    "data":{
        "list":[
            {
                "chain_name":"Ethereum",
                "collection_address":"0x75cdc17e42e1d82a3fdb38c1b8509842f0fcbe20",
                "amount":"467",
                "name":"Wixa",
                "symbol":"WIXA",
                "contract_type":"ERC721",
                "logo_url":"https://i.seadn.io/gcs/files/cda6ecda88582c70dcd22cdf7ff4bd9b.png?w=500&auto=format"
            }
        ],
        "pagination":{
            "current":1,
            "page_size":10,
            "total":1,
            "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"
}