Get Token Holder Balances

import requests
url = "https://l1.avacloud.io/v1/api/chains/chainID/tokens/erc20TokenAddress/balances"
payload = {
    "date": "04/15/2024",
    "checkpoint": "12:00",
    "minimumBalance": "5000000000000000000",
    "walletaddresses": ["0xAb5801a7D398351b8bE11C439e05C5B3259aec9B", "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "token": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
  "as_of_block": 17283945,
  "holders": [
    {
      "address": "0xAb5801a7D398351b8bE11C439e05C5B3259aec9B",
      "balance": "15000000000000000000"
    },
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "balance": "7500000000000000000"
    }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 2,
    "total_pages": 1,
    "total_count": 2
  }
}

Get token holder balances

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

chainIDstringRequired

erc20TokenAddressstringRequired

Query parameters

pageintegerOptional

Page number to return

page_sizeintegerOptional

Number of results per page

Request

This endpoint expects an object.

datestringRequired

Date for the balance snapshot (e.g. 02/24/2026)

checkpointstringRequired

Time checkpoint for the balance snapshot (UTC). Available checkpoints: 00:00, 04:00, 08:00, 12:00, 16:00, 20:00

minimumBalancestringOptional

Minimum balance filter in wei

walletaddresseslist of stringsOptional

List of wallet addresses to check balances for

Response

tokenstring or null

as_of_blockinteger or null

holderslist of objects or null

paginationobject or null

Authentication

Path parameters

Query parameters

Request

Response

Errors