List ERC-20 balances

Lists ERC-20 token balances of a wallet address.

Balance at a given block can be retrieved with the blockNumber parameter.

Balance for specific contracts can be retrieved with the contractAddresses 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

blockNumber

string

The block number, if not defined the block number will be the latest block.

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

filterSpamTokens

boolean

default: true

whether to filter out spam tokens from the response. Default is true.

contractAddresses

string

A comma separated list of contract addresses to filter by.

currency

enum<string>

The currency that return values should use. Defaults to USD.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

Response

200 - application/json

erc20TokenBalances

object[]

required

The list of ERC-20 token balances for the address.

Show child attributes

erc20TokenBalances.address

string

required

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

erc20TokenBalances.name

string

required

The contract name.

erc20TokenBalances.symbol

string

required

The contract symbol.

erc20TokenBalances.decimals

number

required

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

erc20TokenBalances.logoUri

string

The logo uri for the address.

erc20TokenBalances.ercType

enum<string>

required

Available options:

ERC-20

erc20TokenBalances.price

object

The token price, if available.

Show child attributes

erc20TokenBalances.price.currencyCode

enum<string>

required

ISO 4217 currency code.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

erc20TokenBalances.price.value

number

required

Monetary value in base 10 decimals.

erc20TokenBalances.chainId

string

required

The evm chain id.

erc20TokenBalances.balance

string

required

The address balance for the token, in units specified by the decimals value for the contract.

erc20TokenBalances.balanceValue

object

The monetary value of the balance, if a price is available for the token.

Show child attributes

erc20TokenBalances.balanceValue.currencyCode

enum<string>

required

ISO 4217 currency code.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

erc20TokenBalances.balanceValue.value

number

required

Monetary value in base 10 decimals.

erc20TokenBalances.tokenReputation

enum<string> | null

required

Indicates the reputation of the token based on a security analysis. 'Benign' suggests the token is likely safe, while 'Malicious' indicates potential security risks. This field is nullable and is only populated for tokens on the C-Chain. Possible values are 'Benign', 'Malicious', or null if the reputation is unknown.

Available options:

Malicious,

Benign

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.