Entity Performance

We have structured the performance endpoints around three main pillars,

  1. the avg effectiveness of an entity

  2. drilldown of performance associated with attestation duties

  3. drilldown of performance associated with proposer duties

You will find that this is similar to how we defined Rated Effectiveness Rating (RAVER), which is a measure of how well an entity has been performing its deterministic duties - attestations and proposals, over time.

Get effectiveness for Pools, Operators and Addresses

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

Get attestation duties metrics for Pools, Operators and Addresses

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

Get proposer duties metrics for Pools, Operators and Addresses

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

Validator Performance

At validator level, the same structure persists ie the performance endpoints are centered around three main pillars,

  1. the effectiveness of a validator index

  2. drilldown of performance associated with attestation duties

  3. drilldown of performance associated with proposer duties

Validator performance endpoints can further be grouped into individual validator index or pubkey endpoints and aggregate endpoints. Find more details below 👇

Individual Validators

Get validator effectiveness

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

Get validator attestation duties metrics

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

Get validator proposal duties metrics

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

Aggregating Validator Indices

Unlike the entities endpoint, validators can be aggregated across all the metrics that live under the performance endpoints across an arbitrary number of validator indices or pubkeys. This aggregation is available over a time window or over validator indices.

Get aggregated effectiveness for validators

GET
/
v1
/
eth
/
validators
/
effectiveness

Get attestation duties metrics for group of validators

GET
/
v1
/
eth
/
validators
/
attestations

Get proposer duties metrics for a group of validators

GET
/
v1
/
eth
/
validators
/
proposals

Sets Performance

Sets or Private Sets, helps organizations group validators into custom, private, sets enabling use-cases such as executing controlled experiments and analyses to assess various aspects of their validators’ cluster performance. 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 performance endpoints behave identical to the entities performance endpoints with the caveat that (i) only the org that creates a set can view performance metrics for that set (hence private sets) and (ii) sets data does not surface on the Rated Explorer.

Get effectiveness for a private set

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

Get attestation duties metrics for a private set

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

Get proposer duties metrics for a private set

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