Changelog

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].

Compute units (CUs) consumed for API calls are now available in the response header. This has been requested by our customers in order to have more visibility on consumption, and we are glad to have finally enabled this feature.

Below is an example using one of our rewards endpoints.

Request

curl -v -X 'GET' 'https://api.rated.network/v1/eigenlayer/delegators/{delegator_address}/rewards?fromDate=2025-01-15&toDate=2025-01-16' 
-H 'accept: application/json' 
-H 'X-Rated-Network: mainnet' 
-H 'Authorization: Bearer <api_key>

Response header

using HTTP/1.x
GET (…)
Request completely sent off 
< HTTP/1.1 200 OK 
(...)
< x-rated-bytes-consumed: 2069 
< x-rated-compute-units: 6869 
(...)
Connection #0 to host api.rated.network left intact

x-rated-compute-units is the field the that gives the total compute units consumed by the request and the successful response. In this case, the CUs consumed is 6869.

Stay tuned for more releases regarding billing and usage transparency.

For more information on our pricing and the computation of compute units, please see here: https://api-docs.rated.network/pricing/compute-units.

We’ve released three new endpoints regarding daily restaked balances in Eigenlayer. These are:

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

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

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


These endpoints allow you to track restaked balances across operators, delegators, and eigenpods on a daily level.

Sample response:

{
     "date": "2024-10-01",
     "earner": "0xB0bd0c91798d720a5585364bb4be7396c5b9731",
     "strategy": "0x54945180dB7943c0ed0FEE7EdaB2Bd24620256bc",
     "tokenAddress": "0xBe9895146f7AF43049ca1c1AE358B0541Ea49704",
     "totalShares": 12000000000000000000,
     "totalBalance": 12000000000000000000
}

Coupled with our Eigenlayer rewards endpoints, you’ll be able to track rates of return per operator and asset, and manage strategies accordingly.

Speaking of our rewards endpoints, the functionality of these existing endpoints have been extended to enable time-based aggregations using the granularity parameter, specifically weekly aggregations. As such we’re also changing the compute unit consumption of this endpoint to reflect this change; 7x increase to account for the capability to aggregate weekly (from daily).

For more information on these endpoints, please see here:
- Stake state endpoints: https://api-docs.rated.network/rated-api/api-reference/v1/eigenlayer/metadata#stake-state

- Expanded rewards endpoints: https://api-docs.rated.network/rated-api/api-reference/v1/eigenlayer/rewards