January 30th, 2025
We’re excited to announce the launch of Avalanche on the Rated API!
Starting today, you can access and query rewards data for validators on the Avalanche Primary Network, both at an individual level and network level over a specified time period:
GET /v1/avalanche/validators/{node_id}/rewards
Provides a detailed summary of all rewards earned by a specific validator, identified by their node_id
Sample Request
curl -X 'GET' 'https://api.rated.network/v1/avalanche/validators/{node_id}/rewards?fromDate=2024-12-01&toDate=2024-12-05'
-H 'accept: application/json'
-H 'Authorization: Bearer <api_token>'
Sample Response (trimmed for brevity)
{
"previous":null,
"next":null,
"pages":1,
"results":[
{
"day":"2024-12-05",
"nodeId":"{node_id}",
"validationStatus":"inactive",
"validatorPubkey": "0x8f8df4745a1329a6318634e60332df71ecc4a9430d",
"totalDelegatorRewards":1.55,
"totalValidatorRewards":290.90,
"totalValidatorFeeRewards":0.08,
"totalPotentialDelegatorRewards":0,
"totalPotentialValidatorRewards":0,
"totalPotentialValidatorFeeRewards":0
},
<...>
{
"day":"2024-12-01",
"nodeId":"{node_id}",
"validationStatus":"active",
"validatorPubkey": "0x8f8df4745a1329a6318634e60332df71ecc4a9430d",
"totalDelegatorRewards":0,
"totalValidatorRewards":0,
"totalValidatorFeeRewards":0,
"totalPotentialDelegatorRewards":2516.64,
"totalPotentialValidatorRewards":7904.87,
"totalPotentialValidatorFeeRewards":51.50
}
]
}
GET /v1/avalanche/network/rewards
Provides historical network level validator rewards for the Primary Network
Sample Request
curl -X 'GET' 'https://api.rated.network/v1/avalanche/network/rewards?fromDate=2025-01-26&toDate=2025-01-27'
-H 'accept: application/json'
-H 'Authorization: Bearer <api_token>'
Sample Response
{
"previous":null,
"next":null,
"pages":1,
"results":[
{
"day":"2025-01-27",
"totalActiveValidators":1518,
"totalValidatorRewards":6920.434755523,
"totalValidatorFeeRewards":2.489666824,
"totalDelegatorRewards":1717.71544618,
"totalPotentialValidatorRewards":7156084.009812852,
"totalPotentialValidatorFeeRewards":37273.058757847,
"totalPotentialDelegatorRewards":494018.077133481
},
{
"day":"2025-01-26",
"totalActiveValidators":1505,
"totalValidatorRewards":1488.872838484,
"totalValidatorFeeRewards":3.09354756,
"totalDelegatorRewards":2440.470582821,
"totalPotentialValidatorRewards":7152926.77444416,
"totalPotentialValidatorFeeRewards":37281.047946395,
"totalPotentialDelegatorRewards":494245.251667358
}
]
}
Learn more
As with all networks, there are nuances to how rewards behave on Avalanche. We encourage you to check out our API documentation to learn more, which also contains a glossary for the different fields in the responses returned by these endpoints. Lastly, we have historical rewards data going back to October 1, 2024.
Beta Release and Pricing
During the beta period, access to these new endpoints will be free (no compute unit consumption). Compute Unit (CU)-based pricing will be introduced post-beta.
More to come
This is part of Rated’s ongoing effort to expand its coverage to more chains and networks. Stay tuned!
If you have any questions or feedback, feel free to reach out to us at feedback.rated.network or at hello@rated.network.