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 Entity Rewards

GET/eth/entities/{entity_id}/rewards

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('/eth/entities/{entity_id}/rewards?entityType=depositAddress', {
    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
    }
  ]
}

Get Entity Penalties

GET/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('/eth/entities/{entity_id}/penalties?entityType=depositAddress', {
    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

GET/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('/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
    }
  ]
}

Get Validator Penalties

GET/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

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/eth/validators/{validator_index_or_pubkey}/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,
      "estimatedPenalties": -82967688,
      "sumSyncCommitteePenalties": -44317643,
      "sumWrongTargetPenalties": -28763358,
      "sumLateTargetPenalties": 0,
      "sumMissedAttestationPenalties": -1926140,
      "sumWrongHeadPenalties": 0,
      "sumLateSourcePenalties": -7960547
    }
  ]
}

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 Private Set Rewards

GET/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('/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
    }
  ]
}

Get Private Set Penalties

GET/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('/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
    }
  ]
}