Changelog

Follow new updates and improvements to Rated.

January 14th, 2025

Added

New

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

December 20th, 2024

New

We've completed the migration of all Solana API endpoints to the v1 standard, introducing improvements and consistency across our infrastructure:

Key Updates

  • Standardized endpoint naming aligned with v1 schema

  • Enhanced performance via optimized v1 routing

API Reference 👉 https://api-docs.rated.network/rated-api/api-reference/v1/solana

Legacy endpoints will remain operational until we deprecate the v0 endpoints in Q1 2025.

If you’d like support or have questions, please reach out via hello@rated.network. If you have feedback, please let us know via feedback.rated.network

November 26th, 2024

With the implementation of Timely Vote Credits (TVC) on Solana mainnet-beta starting from Epoch 703 (November 26, 2024 07:57:15 UTC), vote latency is now integrated into how we measure how effective a validator is on Solana.

Vote latency is the slot distance between the slot being voted for and the slot where the vote transaction lands. With the implementation of TVC, the protocol now rewards validators based on latency accordingly.

A validator that correctly votes within two (2) slots for the slot it is voting for will get the maximum 16 vote credits. For every slot that a validator delays its vote, it gets one (1) less vote credit, until such that it can only get the minimum of one (1). This means that at 18 slots of worth of latency or more, as long as a validator's vote is correct and is no later than 512 slots, it gets the minimum vote credit.

As such we assign a vote_score for every correct vote based on the vote credits it receives. We then multiply the total number of confirmed blocks by 16 to get the maximum possible vote credits such that the voting effectiveness rating is:

voting effectiveness = vote_score / (total number of confirmed blocks * 16)

We have reflected this change in our methodology docs, under Version 2.0 of the Solana Validator Effectiveness Rating.

November 12th, 2024

New

You can now retrieve performance and rewards data for Ethereum based on UTC time intervals through our v1 endpoints!

How to Use It

Simply add utc=true to your existing API queries. That's it!

Note: UTC data is available for dates from October 1, 2024 onwards

Here's an example of how this would work 👇 When querying Coinbase's effectiveness from Nov 1-7 2024, you'll receive data in daily UTC intervals. 

Day alignment 
Since Ethereum epochs don't align perfectly with UTC midnight (they start at ~23:57 and end at ~00:03), we group epochs that start within a UTC day together. You can learn more about this here.

Ready to try it out? Check out the API docs here  👉  API Reference

If you have any questions or need support, don't hesitate to reach out to our team at hello@rated.network!

October 14th, 2024

New

We’re excited to announce the Beta launch of EigenLayer on the Rated API! Starting today, you can access and query:

  • Rewards data for EigenLayer operators and eigenpods, giving you a breakdown of all rewards earned by an operator and eigenpods over a specified time period across all networks that they are involved in.

    • GET /v1/eigenlayer/eigenpods/{address}/rewards

      • Provides a detailed summary of all rewards earned by a specific Eigenpod across all networks over a specified time period

    • GET /v1/eigenlayer/entities/{entity_id}/rewards

      • Provides the rewards earned by an entity (operator) across all networks over a specified time period

  • Metadata related to EigenLayer operators and delegators, such as the delegation history by delegator or operator address.

    • GET /v1/eigenlayer/delegators/{address}/delegations

      • Data includes delegation details like the delegator’s address, Eigenpod address, operator, and time range for the delegation

    • GET /v1/eigenlayer/operators/{operator_id}/delegations

      • Returns operator delegation data, detailing delegator addresses, Eigenpod addresses, and the time periods for which the operator had delegated stake

      • Data is stored in daily snapshots

API reference for these endpoints can be found 👉 here

Beta Release and Pricing
During the beta period, access to these new endpoints will be free (no CU consumption). CU-based pricing will be introduced post-beta.

If you have any questions or feedback, feel free to reach out to us at hello@rated.network.

October 4th, 2024

Added

Fixed

  • SyncSignatureCount added to entities endpoint

    • The syncSignatureCount field has been added to the /v1/eth/entities/{entity_id}/attestations endpoint, providing a more complete view of validator performance in the sync committee. This field was previously only available in the /v1/eth/validators/{validator_index_or_pubkey}/attestations endpoint

    • Impacted endpoints: v1 entities endpoints

  • Fix for from parameter in ChainDailyRewards endpoint

    • Resolved a 500 error occurring when using the from parameter in the chainDailyRewards endpoint, caused by a datatype mismatch (int vs. string)

    • Additionally, functionality has been added to support using UTC days in the from parameter for greater flexibility

    • Impacted endpoints: v0/eth/network/chainDailyRewards

September 13th, 2024

Fixed

New

  • New Ethereum chain days endpoint

    • Added a new chainDailyRewards endpoint based on Ethereum chain days, in addition to the existing dailyRewards endpoint which is based on UTC days

    • Impacted endpoints: v0/eth/network/chainDailyRewards and v0/eth/network/chainDailyRewards/{day}

  • Additional validator balance field in Rewards endpoint

    • The v0/eth/network/chainDailyRewards endpoint now includes the latest total effective balance of validators, providing more insight into validator performance

  • Slot and timestamp fields added to Rewards endpoints

    • Introduced startSlot, endSlot, startTimestamp, and endTimestamp fields to rewards endpoint

    • The changes impact validator, entities, and network endpoints for enhanced data consistency across different API responses

  • Data type update for execution rewards on Rewards endpoints

    • Modified the data type for execution reward columns (e.g., sum_priority_fees_wei and sum_baseline_mev_wei) from StrictInt to Decimal to improve accuracy.

    • Impacted endpoints: v1 rewards endpoints for validators

September 6th, 2024

Deprecated

Effective Date: September 06, 2024

We are officially deprecating support for the Polygon network on both the Rated Explorer and the Rated API. Due to a lack of widespread adoption and the high cost of maintenance, we’ve made the decision to discontinue support.

  • Impact: Users will no longer be able to access Polygon-related data or functionality in the Rated Explorer and Rated API after the deprecation date.

If you’re impacted and need assistance, please reach out to us at hello@rated.network!

July 25th, 2024

Deprecated

We are discontinuing support for hourly updates on the validator endpoints and the predicted withdrawals feature due to low adoption rate and increased maintenance costs.

This change is effective as of July 24,2024.

Impacted Endpoints

Validator Endpoints

/v1/eth/validators/{validator_index_or_pubkey}/effectiveness
/v1/eth/validators/{validator_index_or_pubkey}/attestations
/v1/eth/validators/{validator_index_or_pubkey}/proposals
/v0/eth/validators/{validator_index_or_pubkey}/effectiveness

Predicted Withdrawal Endpoints

/v0/eth/withdrawals/predicted/operators/{operator_id}
/v0/eth/withdrawals/predicted/operators/{operator_id}

Key Resources

For support inquiries, please contact us at hello@rated.network. If you have feedback, we would love to hear from you at feedback.rated.network!

May 15th, 2024

Changed

We have enhanced our Ethereum blocks endpoints to support real-time data retrieval. Users can now access data that is up to 2 epochs behind the current head of the chain at any time.

Impacted Endpoints

/v0/eth/blocks
/v0/eth/blocks/{consensus_slot}

Key Resources


For support inquiries, please contact us at hello@rated.network. If you have feedback, we would love to hear from you at feedback.rated.network!