GET
/
v0
/
eth
/
validators
/
{validator_index_or_pubkey}
/
effectiveness
curl --request GET \
  --url https://api.rated.network/v0/eth/validators/{validator_index_or_pubkey}/effectiveness \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "attesterEffectiveness": 98.82005899705014,
      "avgCorrectness": 0.9925925925925926,
      "avgInclusionDelay": 1.0044444444444445,
      "day": 803,
      "earnings": 2958548,
      "endEpoch": 180675,
      "estimatedPenalties": -6461,
      "estimatedRewards": 2965823,
      "executionProposedEmptyCount": 0,
      "proposedCount": 0,
      "proposerDutiesCount": 0,
      "slashesCollected": 0,
      "slashesReceived": 0,
      "startEpoch": 180899,
      "sumAllRewards": 2958548,
      "sumAttestationRewards": 2965823,
      "sumBaselineMev": 0,
      "sumConsensusBlockRewards": 0,
      "sumCorrectHead": 221,
      "sumCorrectSource": 225,
      "sumCorrectTarget": 224,
      "sumExternallySourcedExecutionRewards": 0,
      "sumInclusionDelay": 226,
      "sumLateSourcePenalties": 0,
      "sumLateSourceVotes": 0,
      "sumLateTargetPenalties": 0,
      "sumLateTargetVotes": 0,
      "sumMissedAttestationPenalties": 0,
      "sumMissedAttestationRewards": 19233,
      "sumMissedAttestations": 0,
      "sumMissedConsensusBlockRewards": 0,
      "sumMissedExecutionRewards": 0,
      "sumMissedSyncCommitteeRewards": 0,
      "sumPriorityFees": 0,
      "sumSyncCommitteePenalties": 0,
      "sumWrongHeadPenalties": 0,
      "sumWrongHeadVotes": 3,
      "sumWrongTargetPenalties": -6461,
      "sumWrongTargetVotes": 1,
      "syncSignatureCount": 0,
      "totalAttestationAssignments": 225,
      "totalAttestations": 237,
      "totalUniqueAttestations": 225,
      "uptime": 1,
      "validatorEffectiveness": 98.82005899705014,
      "validatorIndex": 100
    }
  ],
  "next": "/v0/eth/validators/100/effectiveness?size=1&from=802&granularity=day&filterType=day",
  "page": {
    "filterType": "day",
    "granularity": "day",
    "size": 1
  },
  "total": 804
}

This endpoint returns all the useful information you will ever need on the historical performance of a single validator index. This includes rewards (aggregate and granular), performance (effectiveness and its components), slashing history and much more. For a glossary of the variables returned see effectiveness.

Here’s how to interpret the inputs required to operate it 👇

ParameterContext
filterTypeday and datetime
fromStart day (integer) or datetime (e.g. from=“2022-12-01”)
granularityThe size of time increments you are looking to query. Can be day / week / month / quarter / year
sizeThe number of results included per page
includeA list of field names. Use it to filter the specific fields you want in the response payload

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Rated-Network
enum<string>
Available options:
mainnet,
hoodi,
holesky

Path Parameters

​
validator_index_or_pubkey
required
Required range: x >= 0

Query Parameters

​
from
Required range: x >= 0
​
size
integer
default:10
​
granularity
enum<string>
Available options:
day,
week,
month,
quarter,
year,
all
​
filterType
enum<string>
Available options:
hour,
day,
datetime
​
include
string[] | null

Response

200
application/json

Successful Response

The response is of type object.