v1

latestOpenAPI 3.1.02026-07-12185391.3 KB
Looking Glass

Get list of addresses and their latest balances that have held more than a certain threshold of a given token during the specified time frame. Supported only on Avalanche C-Chain (mainnet, chainId 43114).

get/v2/chains/{chainId}/contracts/{address}/balances

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

Contract address on the relevant chain.

Query parameters

thresholdstring required

The minimum balance for which addresses should be considered.

startTimestampinteger

Query param for retrieving items after a specific timestamp.

endTimestampinteger

Query param for retrieving items before a specific timestamp.

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

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

{
  "addresses": [
    {
      "address": "0x1234567890abcdef1234567890abcdef123456789"
    }
  ]
}