Rewards

A series of endpoints that drill down on rewards related metrics for both entities and validators.

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 penalty metrics for Pools, Operators and Addresses

This endpoint returns a bunch of useful information about the historical penalties accrued by a single pool, node operator or deposit/withdrawal addresses.

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

Path parameters

entity_id*Entity Id

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/entities/{entity_id}/penalties?entityType=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "day": 796,
      "hour": 19056,
      "startDate": "2023-01-01",
      "endDate": "2023-01-07",
      "startDay": 796,
      "endDay": 802,
      "date": "2023-01-01",
      "startEpoch": 63744,
      "endEpoch": 63775,
      "validatorCount": 16075,
      "sumEstimatedPenalties": -82967688,
      "sumSyncCommitteePenalties": -44317643,
      "sumWrongTargetPenalties": -28763358,
      "sumLateTargetPenalties": 0,
      "sumMissedAttestationPenalties": -1926140,
      "sumWrongHeadPenalties": 0,
      "sumLateSourcePenalties": -7960547
    }
  ]
}

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

This endpoint returns a bunch of useful information about the historical rewards earned by a single validator index.

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

Path parameters

validator_index_or_pubkey*Validator Index Or Pubkey

integerstring

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/validators/{validator_index_or_pubkey}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "day": 796,
      "hour": 19056,
      "startDate": "2023-01-01",
      "endDate": "2023-01-07",
      "startDay": 796,
      "endDay": 802,
      "date": "2023-01-01",
      "startEpoch": 63744,
      "endEpoch": 63775,
      "validatorCount": 16075,
      "rewards": 56766373292,
      "estimatedRewards": 56675239144,
      "sumPriorityFees": 10662221791,
      "sumBaselineMev": 5266131924,
      "sumMissedExecutionRewards": 58181568,
      "sumConsensusBlockRewards": 6554423259,
      "sumMissedConsensusBlockRewards": 31228533,
      "sumAllRewards": 72694727007,
      "sumAttestationRewards": 50120815885,
      "sumMissedAttestationRewards": 269961427,
      "sumMissedSyncCommitteeRewards": 44317643,
      "sumExternallySourcedExecutionRewards": 14862131536,
      "sumSyncCommitteeRewards": 44317643,
      "endEpochBalance": 34230000000,
      "endEpochEffectiveBalance": 32000000000,
      "sumPriorityFeesWei": 10662221791000000000,
      "sumBaselineMevWei": 5266131924000000000
    }
  ]
}

Get validator penalty metrics

This endpoint returns a bunch of useful information about the historical penalties accrued by a single validator index.

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

Path parameters

validator_index_or_pubkey*Validator Index Or Pubkey

integerstring

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/validators/{validator_index_or_pubkey}/penalties', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}

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

This endpoint returns a bunch of useful information about the historical rewards earned by all validators belonging to a private set.

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

Path parameters

set_id*Set Id

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/sets/{set_id}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "day": 796,
      "hour": 19056,
      "startDate": "2023-01-01",
      "endDate": "2023-01-07",
      "startDay": 796,
      "endDay": 802,
      "date": "2023-01-01",
      "startEpoch": 63744,
      "endEpoch": 63775,
      "validatorCount": 16075,
      "sumRewards": 56766373292,
      "sumEstimatedRewards": 56675239144,
      "sumPriorityFees": 10662221791,
      "sumBaselineMev": 5266131924,
      "sumMissedExecutionRewards": 58181568,
      "sumConsensusBlockRewards": 6554423259,
      "sumMissedConsensusBlockRewards": 31228533,
      "sumAllRewards": 72694727007,
      "sumAttestationRewards": 50120815885,
      "sumMissedAttestationRewards": 269961427,
      "sumMissedSyncCommitteeRewards": 44317643,
      "sumExternallySourcedExecutionRewards": 14862131536,
      "sumSyncCommitteeRewards": 44317643
    }
  ]
}

---

Get penalty metrics for a private set

This endpoint returns a bunch of useful information about the historical penalties accrued by all validators belonging to a private set.

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

Path parameters

set_id*Set Id

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/sets/{set_id}/penalties', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "day": 796,
      "hour": 19056,
      "startDate": "2023-01-01",
      "endDate": "2023-01-07",
      "startDay": 796,
      "endDay": 802,
      "date": "2023-01-01",
      "startEpoch": 63744,
      "endEpoch": 63775,
      "validatorCount": 16075,
      "sumEstimatedPenalties": -82967688,
      "sumSyncCommitteePenalties": -44317643,
      "sumWrongTargetPenalties": -28763358,
      "sumLateTargetPenalties": 0,
      "sumMissedAttestationPenalties": -1926140,
      "sumWrongHeadPenalties": 0,
      "sumLateSourcePenalties": -7960547
    }
  ]
}