Rewards
A series of endpoints that drill down on rewards related metrics for validators and the network.
Last updated
A series of endpoints that drill down on rewards related metrics for validators and the network.
Last updated
These rewards currently only include rewards from the Primary Network.
The historical daily rewards are available from October 1, 2024.
Rewards on Avalanche are very straightforward as it is only based on a validator's uptime as observed by its peers. There are no other reward mechanisms on the Avalanche Primary Network, mostly due to the fact that all transaction fees are burned.
A validator is considered “up” if it responds to queries promptly (e.g. preference sampling and block proposals). Every validator on Avalanche keeps track of the uptime of other validators, with each validator being weighted by its stake. The more stake a validator has, the more influence they have when validators vote on whether a validator should receive a staking reward.
The validator is then rewarded if its uptime is above the uptime-requirement threshold, which is currently set to 80%. These rewards are denominated in AVAX.
There are different types of rewards that a validator receives based on its uptime performance:
VALIDATOR: rewards paid to the validator for their own committed stake
DELEGATOR: rewards paid to the delegator for their committed stake.
VALIDATOR_FEE: rewards paid to the validator as its cut/commission from the delegators' rewards (depends on the commission rate set by the validator)
These rewards are distributed at different periods depending on the type. Delegator rewards are distributed at the end of the delegation period set by the delegator. Validator and validator fee rewards are distributed when a validator completes its set validation period (i.e. at the end).
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 (DELEGATORreward 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.
This network rewards endpoint gives you a breakdown of all validator rewards (earned and potential) over a specified period of time. The count of active validators is also given per day.
This endpoint returns the historical rewards earned by a single validator and their potential rewards.
Successful Response
This endpoint returns the historical rewards earned by the network and potential rewards.
Successful Response