Skip to main content
GET
/
v0
/
eth
/
validators
/
{validator_index_or_pubkey}
/
effectiveness
Get Effectiveness
curl --request GET \
  --url https://api.rated.network/v0/eth/validators/{validator_index_or_pubkey}/effectiveness \
  --header 'Authorization: Bearer <token>'
{
  "page": {
    "from": 123,
    "to": 123,
    "size": 10,
    "granularity": "hour",
    "filterType": "hour"
  },
  "total": 1,
  "data": [
    {
      "totalAttestations": 1,
      "totalUniqueAttestations": 1,
      "sumCorrectHead": 1,
      "sumCorrectTarget": 1,
      "avgCorrectness": 1,
      "totalAttestationAssignments": 1,
      "avgInclusionDelay": 1,
      "sumInclusionDelay": 1,
      "uptime": 1,
      "attesterEffectiveness": 1,
      "proposedCount": 1,
      "proposerDutiesCount": 1,
      "proposerEffectiveness": 1,
      "slashesCollected": 1,
      "slashesReceived": 1,
      "earnings": 123,
      "syncSignatureCount": 1,
      "validatorEffectiveness": 1,
      "estimatedRewards": 123,
      "estimatedPenalties": 123,
      "sumPriorityFees": 1,
      "sumBaselineMev": 123,
      "sumMissedExecutionRewards": 123,
      "sumConsensusBlockRewards": 123,
      "sumMissedConsensusBlockRewards": 123,
      "sumAllRewards": 123,
      "sumCorrectSource": 1,
      "sumMissedSyncSignatures": 1,
      "sumSyncCommitteePenalties": 123,
      "sumLateSourceVotes": 1,
      "sumWrongTargetVotes": 1,
      "sumLateTargetVotes": 1,
      "sumWrongTargetPenalties": 123,
      "sumLateTargetPenalties": 123,
      "sumMissedAttestations": 1,
      "sumMissedAttestationPenalties": 123,
      "sumWrongHeadVotes": 1,
      "sumWrongHeadPenalties": 123,
      "sumAttestationRewards": 1,
      "sumLateSourcePenalties": 123,
      "executionProposedEmptyCount": 1,
      "sumMissedAttestationRewards": 1,
      "sumMissedSyncCommitteeRewards": 1,
      "sumExternallySourcedExecutionRewards": 123,
      "validatorIndex": 1,
      "startEpoch": 1,
      "endEpoch": 1,
      "hour": 1,
      "day": 1,
      "startDay": 1,
      "endDay": 1
    }
  ],
  "next": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.rated.network/llms.txt

Use this file to discover all available pages before exploring further.

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>
default:mainnet
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>
default:day
Available options:
day,
week,
month,
quarter,
year,
all
​
filterType
enum<string>
Available options:
hour,
day,
datetime
​
include
string[] | null

Response

Successful Response

​
page
Page · object
required
​
total
integer
required
Required range: x >= 0
​
data
ValidatorEffectiveness · object[]
required
​
next
string | null
required