Query collections on all chains by user address

Description

  • Method:HTTPS GET

  • Encoding:UTF-8

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

  • Description: Query collections on all chains by 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_names

N

Array

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_all_collection_list?chain_names=eth,pol&address=0xaf3b503f13c9d665f5eb1b375a741108b7df6ba9&page=1&page_size=10"

Successful Response Sample

{
    "success":true,
    "data":{
        "list":[
            {
                "chain_name":"Ethereum",
                "collection_address":"0x0fcbd68251819928c8f6d182fc04be733fa94170",
                "amount":"6",
                "name":"LO-FI PEPE",
                "symbol":"LOFI",
                "contract_type":"ERC721",
                "logo_url":"https://i.seadn.io/gcs/files/1ebd7dc64542260fb412f383617969b3.gif?w=500&auto=format"
            },
            {
                "chain_name":"Polygon",
                "collection_address":"0x43bcad6eff1fa2e75a66b975668a9a5edc077cba",
                "amount":"1",
                "name":"Mining PONDXCOIN.COM",
                "symbol":"POND",
                "contract_type":"ERC721",
                "logo_url":null
            }
        ],
        "pagination":{
            "current":1,
            "page_size":10,
            "total":2,
            "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"
}

Last updated