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>'
{
  "previous": "<string>",
  "next": "<string>",
  "pages": 1,
  "results": [
    {
      "day": "2023-12-25",
      "nodeId": "<string>",
      "validationStatus": "<string>",
      "validatorPubkey": "<string>",
      "totalDelegatorRewards": 123,
      "totalValidatorRewards": 123,
      "totalValidatorFeeRewards": 123,
      "totalPotentialDelegatorRewards": 123,
      "totalPotentialValidatorRewards": 123,
      "totalPotentialValidatorFeeRewards": 123
    }
  ]
}
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

Example:

"2023-12-31"

​
fromDate
string<date> | null

Start date

Example:

"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