Skip to main content
GET
/
v1
/
chains
/
{chainId}
/
addresses
/
{address}
/
balances:listErc20
JavaScript
import { Avalanche } from "@avalanche-sdk/chainkit";

const avalanche = new Avalanche({
  chainId: "43114",
});

async function run() {
  const result = await avalanche.data.evm.address.balances.listErc20({
    blockNumber: "6479329",
    pageSize: 10,
    address: "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    contractAddresses: "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7, 0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB",
    currency: "usd",
  });

  for await (const page of result) {
    console.log(page);
  }
}

run();
{
  "nativeTokenBalance": {
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "chainId": "<string>",
    "balance": "<string>",
    "logoUri": "<string>",
    "price": {
      "currencyCode": "usd",
      "value": 123
    },
    "balanceValue": {
      "currencyCode": "usd",
      "value": 123
    }
  },
  "erc20TokenBalances": [
    {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "ercType": "ERC-20",
      "chainId": "<string>",
      "balance": "<string>",
      "tokenReputation": "Malicious",
      "logoUri": "<string>",
      "price": {
        "currencyCode": "usd",
        "value": 123
      },
      "balanceValue": {
        "currencyCode": "usd",
        "value": 123
      }
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

​
x-glacier-api-key
string
header
required

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 500.

Required range: 1 <= x <= 500
​
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. ISO 4217 currency code.

Available options:
usd,
eur,
aud,
cad,
chf,
clp,
cny,
czk,
dkk,
gbp,
hkd,
huf,
jpy,
nzd

Response

Successful response

​
nativeTokenBalance
object
required

The native token balance for the address.

​
erc20TokenBalances
object[]
required

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

​
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.