Granite Upgrade Activates in11d:16h:54m:29s
Looking Glass

Get addresses running validators during a given time frame

Get list of addresses and AddValidatorTx timestamps set to receive awards for validation periods during the specified time frame.

GET
/v2/subnets/{subnetId}/validators:getAddresses

Path Parameters

subnetIdstring

The subnet ID to filter by.

Query Parameters

startTimestamp?integer

Query param for retrieving items after a specific timestamp.

Range0 <= value
endTimestamp?integer

Query param for retrieving items before a specific timestamp.

Range0 <= value
pageToken?string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize?integer

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 5000.

Default1000
Range1 <= value <= 5000
network?string

Either mainnet or testnet/fuji.

Value in"mainnet" | "fuji" | "testnet"

Response 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/subnets/11111111111111111111111111111111LpoYY/validators:getAddresses?startTimestamp=1689541049&endTimestamp=1689800249&pageSize=10&network=mainnet"
{
  "nextPageToken": "string",
  "addresses": [
    {
      "addresses": [
        "avax1abcdef1234567890abcdef1234567890abcdef"
      ],
      "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?