List collectible (ERC-721/ERC-1155) balances

Lists ERC-721 and ERC-1155 token balances of a wallet address.

Balance for a specific contract can be retrieved with the contractAddress parameter.

Authorizations

x-glacier-api-key

string

headerrequired

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

chainId

string

required

A supported evm chain id or blockchain id. Use the /chains endpoint to get a list of supported chain ids.

address

string

required

A wallet address.

Query Parameters

pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize

integer

default: 10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 < x < 100

contractAddress

string

A contract addresses to filter by.

Response

200 - application/json

collectibleBalances

object[]

required

The list of ERC-721 and ERC-1155 token balances for the address.

• Option 1
• Option 2

Show child attributes

collectibleBalances.address

string

required

A wallet or contract address in mixed-case checksum encoding.

collectibleBalances.name

string

required

The contract name.

collectibleBalances.symbol

string

required

The contract symbol.

collectibleBalances.ercType

enum<string>

required

Available options:

ERC-721

collectibleBalances.tokenId

string

required

collectibleBalances.tokenUri

string

required

collectibleBalances.metadata

object

required

Show child attributes

collectibleBalances.metadata.indexStatus

enum<string>

required

The metadata indexing status of the nft.

Available options:

UNKNOWN,

MISSING_TOKEN,

INVALID_TOKEN_URI,

INVALID_TOKEN_URI_SCHEME,

UNREACHABLE_TOKEN_URI,

THROTTLED_TOKEN_URI,

METADATA_CONTENT_TOO_LARGE,

INVALID_METADATA,

INVALID_METADATA_JSON,

INDEXED,

UNINDEXED

collectibleBalances.metadata.metadataLastUpdatedTimestamp

number

collectibleBalances.metadata.name

string

collectibleBalances.metadata.symbol

string

collectibleBalances.metadata.imageUri

string

collectibleBalances.metadata.description

string

collectibleBalances.metadata.animationUri

string

collectibleBalances.metadata.externalUrl

string

collectibleBalances.metadata.background

string

collectibleBalances.metadata.attributes

string

collectibleBalances.ownerAddress

string

A wallet or contract address in mixed-case checksum encoding.

collectibleBalances.chainId

string

required

The evm chain id.

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.