Query items by chain name, collection address and user address

Description

  • Method: HTTPS GET

  • Encoding: UTF-8

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

  • Description: Query items by chain name, collection address 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

collection_addresses

N

Array

Collection's addresses

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

HolderItem Content

Parameter
Required
Type
Description

chain_name

Y

String

Chain's name

collection_address

Y

String

Collection's address

item_id

Y

String

Collection's item id

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

The amount of NFT items held by the user

mint_block

Y

Long

The block height when the NFT was minted

last_metadata_sync

Y

Long

When the metadata was last updated at

last_token_uri_sync

Y

Long

When the token_uri was last updated at

item_metadata

Y

ItemMetadata

Item's metadata

ItemMetadata Content

Parameter
Required
Type
Description

item_name

Y

String

Item's name

description

Y

String

The description of the item

item_url

Y

String

URL of the item metadata

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

List of attributes

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/user/nft/wallet_item_list?chain_name=eth&address=0xb0642076a64b270176cb92f73f4786daccc7d776&collection_addresses=0x932261f9fc8da46c4a22e31b45c4de60623848bf,0x0000000000664ceffed39244a8312bd895470803&page=1&page_size=10"

Successful Response Sample

Failed Response Sample

Last updated