Entity Rewards

The rewards endpoints give you a breakdown of all rewards earned and penalties accrued by an entity over time. Please head to our Glossary to understand what individual metrics refer to.

Get rewards metrics for Pools, Operators and Addresses

GET
/
v1
/
eth
/
entities
/
{entity_id}
/
rewards

Get penalty metrics for Pools, Operators and Addresses

GET
/
v1
/
eth
/
entities
/
{entity_id}
/
penalties

Validator Rewards

Similar to the entity rewards endpoints, the validator rewards endpoints provide a breakdown of all rewards earned and penalties accrued by a single validator index or pubkey over time. Please head to our Glossary to understand what individual metrics refer to.

Get validator rewards metrics

GET
/
v1
/
eth
/
validators
/
{validator_index_or_pubkey}
/
rewards

Get validator penalty metrics

GET
/
v1
/
eth
/
validators
/
{validator_index_or_pubkey}
/
penalties

Sets Rewards

Sets or Private Sets, helps organizations group validators into custom, private, sets enabling usecases such as executing controlled experiments and analyses to assess various aspects of their validators’ cluster performance and rewards metrics. Head to Private Sets to learn more about the different endpoints you’ll need to call as a precursor to calling the endpoints below.

Note that the set rewards endpoints behave identical to the entities rewards endpoints with the caveat that (i) only the org that creates a set can view rewards metrics for that set (hence private sets) and (ii) sets data does not surface on the Rated Explorer.

Get rewards metrics for a private set

GET
/
v1
/
eth
/
sets
/
{set_id}
/
rewards

Get penalty metrics for a private set

GET
/
v1
/
eth
/
sets
/
{set_id}
/
penalties