Skip to main content
GET
/
v1
/
avalanche
/
validators
/
{node_id}
/
rewards
Get validator rewards metrics
curl --request GET \
  --url https://api.rated.network/v1/avalanche/validators/{node_id}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "next": "https://api.rated.network//v1/avalanche/validators/{node_id}/rewards?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/avalanche/validators/{node_id}/rewards?limit=10&offset=10",
  "results": [
    [
      {
        "day": "2023-01-01",
        "nodeId": "NodeID-EggGmnQFaTffeRNG1Kzs9dXJzFGdxac3D",
        "totalDelegatorRewards": 42,
        "totalPotentialDelegatorRewards": 230,
        "totalPotentialValidatorFeeRewards": 6,
        "totalPotentialValidatorRewards": 120,
        "totalValidatorFeeRewards": 1.2,
        "totalValidatorRewards": 24,
        "validationStatus": "Active",
        "validatorPubkey": "0x8f95423f7142d00a48e1014a3de8d28907d420dc33b3052a6dee03a3f2941a393c2351e354704ca66a3fc29870282e15"
      }
    ]
  ]
}
Using this endpoint, you can query the historical daily rewards of a validator by their unique node_id. In Avalanche, rewards are distributed at the end of validation periods for validators (VALIDATOR and VALIDATOR_FEE reward types) and delegation periods for delegators (DELEGATOR reward type). This is how we match the rewards to a particular date. We match delegator rewards to the validator where delegators have staked/delegated to in order to give a full picture of rewards related to a validator. As mentioned earlier, there are different reward types but Avalanche also computes the maximum potential reward a validator can receive at the end of validation and delegation periods. This is based on a validator having 100% uptime for its validation period (i.e. receiving the maximum rewards possible). In the response, this is given by the prefix potential_ and is specified per reward type, wherein we return these potential rewards as of a particular date.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
node_id
string
required

Query Parameters

​
limit
integer
default:10

The number of results returned per page

​
offset
integer
default:0

The number of results to skip before starting to return

​
toDate
string<date> | null

End date

Examples:

"2023-12-31"

​
fromDate
string<date> | null

Start date

Examples:

"2023-01-01"

Response

Successful Response

​
previous
string | null
required
​
next
string | null
required
​
pages
integer
required
Required range: x >= 0
​
results
AvalancheValidatorRewards · object[]
required