Skip to main content

Changelog

Follow new updates and improvements to Rated.

Celestia is now live on the Rated API

We’re excited to announce the launch of Celestia on the Rated API!

Starting today, you can access and query rewards data for validators on the Celestia, both at an individual level and network level over a specified time period:

GET /v1/celestia/validators/{node_id}/rewards

  • Provides a detailed summary of all rewards earned by a specific validator, identified by their validator_address

Sample Request

curl -X 'GET' 'https://api.rated.network/v1/celestia/{validator_address}/rewards?fromDate=2025-01-01&toDate=2025-01-05' 
-H 'accept: application/json' 
-H 'Authorization: Bearer <api_token>'

Sample Response (trimmed for brevity)

{
   "previous":null,
   "next":null,
   "pages":1,
   "results":[
      {
         "day":"2025-01-05",
         "validator":"{validator_address}",
         "validatorMoniker":"{validator_name}",
         "consensusAddress":"celestiavalcons1uh9wyuh",
         "consensusPubkey":"vrSsYrWno/rLAE0aGsqO/XkrE=",
         "accountAddress":"celestia1xqc7wkg4tswjt7mn4p38v",
         "fromBlockNumber":3330254,
         "toBlockNumber":3346421,
         "totalDelegationRewards":3458.99139127356,
         "totalCommissionRewards":345.899139127356,
         "commissionRate":0.1
      },
<...>
      {
         "day":"2025-01-01",
         "validator":"{validator_address}",
         "validatorMoniker":"{validator_name}",
         "consensusAddress":"celestiavalcons1uh9wyuh",
         "consensusPubkey":"vrSsYrWno/rLAE0aGsqO/XkrE=",
         "accountAddress":"celestia1xqc7wkg4tswjt7mn4p38v",
         "fromBlockNumber":3314016,
         "toBlockNumber":3330253,
         "totalDelegationRewards":3731.780361524,
         "totalCommissionRewards":373.17802385361523,
         "commissionRate":0.1
      }
   ]
}

GET /v1/celestia/network/rewards

  • Provides historical network level validator rewards for Celestia

Sample Request

curl -X 'GET' 'https://api.rated.network/v1/celestia/network/rewards?fromDate=2025-01-01&toDate=2025-01-02' 
-H 'accept: application/json' 
-H 'Authorization: Bearer <api_token>'

Sample Response

{
   "previous":null,
   "next":null,
   "pages":1,
   "results":[
      {
         "day":"2025-01-02",
         "fromBlockNumber":3330254,
         "toBlockNumber":3346421,
         "totalBondedValidators":100,
         "totalDelegationRewards":208637.819,
         "totalCommissionRewards":26793.123,
         "avgCommissionRate":0.0932
      },
      {
         "day":"2025-01-01",
         "fromBlockNumber":3314016,
         "toBlockNumber":3330253,
         "totalBondedValidators":100,
         "totalDelegationRewards":208605.944,
         "totalCommissionRewards":26792.561,
         "avgCommissionRate":0.0932
      }
   ]
}

Learn more
We encourage you to check out our API documentation to learn more about rewards behavior on Celestia. You can also find a glossary for the different fields in the responses returned by these endpoints. Lastly, we have historical rewards data going back to December 1, 2024, and are currently working to extend this further back into October 1, 2024.

Beta Release and Pricing
During the beta period, access to these new endpoints will be free. Compute unit 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 for more!

If you have any questions or feedback, especially on which networks we should cover, feel free to reach out to us at feedback.rated.network or at [email protected].

New

Launching support for Avalanche on Rated API (beta)

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 [email protected].

Fixed: Bug in Eigenlayer Rewards Feed

The issue we mentioned last week with the ethPrice and usdPrice being returned by our Eigenlayer rewards endpoints has been fixed. Specifically these endpoints are:

  • /v1/eigenlayer/entities/{operator_address}/rewards/

  • v1/eigenlayer/delegators/{delegator_address}/rewards/

  • v1/eigenlayer/eigenpods/{eigenpod_address}/rewards

We have also applied the correct historical conversion rates to past rewards. This means that both historical rewards and rewards moving forward will have the correct ETH and USD pricing as long as the particular set of rewards are claimable (activatedAt) and the related token has the appropriate liquidity.

Rest assured that we have taken steps to ensure that instances like this are minimized moving forward.

If you have any questions or feedback, feel free to go to feedback.rated.network.

For more information on our API endpoints, please see our documentation.

Earlier updates