Get addresses by balance over time
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.
Path Parameters
A supported evm chain id. Use the /chains endpoint to get a list of supported chain ids.
Contract address on the relevant chain.
Query Parameters
The minimum balance for which addresses should be considered.
Query param for retrieving items after a specific timestamp.
0 <= valueQuery param for retrieving items before a specific timestamp.
0 <= valueA page token, received from a previous list call. Provide this to retrieve the subsequent page.
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 5000.
10001 <= value <= 5000Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://metrics.avax.network/v2/chains/43114/contracts/0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E/balances?threshold=1000000&startTimestamp=1689541049&endTimestamp=1689800249&pageSize=10"{
"nextPageToken": "string",
"addresses": [
{
"address": "0x1234567890abcdef1234567890abcdef123456789",
"sortKey": 123
}
]
}{
"message": "string",
"statusCode": 400,
"error": "Bad Request"
}{
"message": "string",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "string",
"statusCode": 403,
"error": "Forbidden"
}{
"message": "string",
"statusCode": 404,
"error": "Not Found"
}{
"message": "string",
"statusCode": 429,
"error": "Too Many Requests"
}{
"message": "string",
"statusCode": 500,
"error": "Internal Server Error"
}{
"message": "string",
"statusCode": 502,
"error": "Bad Gateway"
}{
"message": "string",
"statusCode": 503,
"error": "Service Unavailable"
}Is this guide helpful?