Sign in

v1

latestOpenAPI 3.1.02026-07-1288262495.0 KB
EVM Balances

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.

get/v1/chains/{chainId}/addresses/{address}/balances:listErc20

Path parameters

chainIdstring required

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

addressstring required

A wallet address.

Query parameters

blockNumberstring

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

pageTokenstring

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

pageSizeinteger

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

filterSpamTokensboolean

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

contractAddressesstring

A comma separated list of contract addresses to filter by.

currency'usd' | 'eur' | 'aud' | 'cad' | 'chf' | 'clp' | 'cny' | 'czk' | 'dkk' | 'gbp' | 'hkd' | 'huf' | 'jpy' | 'nzd'

ISO 4217 currency code.

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

Response

Successful response

nextPageTokenstring

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.

Example response

{
  "nativeTokenBalance": {
    "name": "Wrapped AVAX",
    "symbol": "WAVAX",
    "decimals": 18,
    "logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
    "chainId": "43114",
    "balance": "2000000000000000000"
  },
  "erc20TokenBalances": [
    {
      "address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
      "name": "Wrapped AVAX",
      "symbol": "WAVAX",
      "decimals": 18,
      "logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
      "chainId": "43114",
      "balance": "2000000000000000000",
      "tokenReputation": "Malicious"
    }
  ]
}