Get Token Holder Balances

curl -X POST https://l1.avacloud.io/v1/api/chains/chainID/tokens/erc20TokenAddress/balances \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "minimumBalance": "5000000000000000000",
  "walletaddresses": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "0x53d284357ec70cE289D6D64134DfAc8E511c8a3D"
  ]
}'

{
  "token": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
  "as_of_block": 17234567,
  "checkpoint_date": "2024-06-01",
  "checkpoint": "2024-06-01T12:00:00Z",
  "holders": [
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "balance": "15000000000000000000"
    },
    {
      "address": "0x53d284357ec70cE289D6D64134DfAc8E511c8a3D",
      "balance": "8000000000000000000"
    }
  ],
  "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.

minimumBalancestringOptional

Minimum balance filter in wei

walletaddresseslist of stringsOptional

List of wallet addresses to check balances for

Response

tokenstring

as_of_blockinteger

checkpoint_datestring

Date of the balance snapshot

checkpointstring

Time checkpoint of the balance snapshot (UTC)

holderslist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error