Skip to main content
GET
/
v0
/
eth
/
validators
/
effectiveness
Get Effectiveness Aggregation
curl --request GET \
  --url https://api.rated.network/v0/eth/validators/effectiveness \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "attesterEffectiveness": 98.46868397067385,
      "avgCorrectness": 0.9951851851851852,
      "avgInclusionDelay": 1.0107407407407407,
      "day": 803,
      "earnings": 35804991,
      "endDay": 792,
      "endEpoch": 178200,
      "estimatedPenalties": -22921,
      "estimatedRewards": 35849013,
      "executionProposedEmptyCount": 0,
      "proposedCount": 0,
      "proposerDutiesCount": 0,
      "slashesCollected": 0,
      "slashesReceived": 0,
      "startDay": 803,
      "startEpoch": 180899,
      "sumAllRewards": 35804991,
      "sumAttestationRewards": 35849013,
      "sumBaselineMev": 0,
      "sumConsensusBlockRewards": 0,
      "sumCorrectHead": 2665,
      "sumCorrectSource": 2699,
      "sumCorrectTarget": 2697,
      "sumExternallySourcedExecutionRewards": 0,
      "sumInclusionDelay": 2729,
      "sumLateSourcePenalties": -3486,
      "sumLateSourceVotes": 1,
      "sumLateTargetPenalties": 0,
      "sumLateTargetVotes": 0,
      "sumMissedAttestationPenalties": 0,
      "sumMissedAttestationRewards": 137813,
      "sumMissedAttestations": 0,
      "sumMissedConsensusBlockRewards": 0,
      "sumMissedExecutionRewards": 0,
      "sumMissedSyncCommitteeRewards": 0,
      "sumPriorityFees": 0,
      "sumSyncCommitteePenalties": 0,
      "sumWrongHeadPenalties": 0,
      "sumWrongHeadVotes": 21,
      "sumWrongTargetPenalties": -19435,
      "sumWrongTargetVotes": 3,
      "syncSignatureCount": 0,
      "totalAttestationAssignments": 2700,
      "totalAttestations": 2919,
      "totalUniqueAttestations": 2700,
      "uptime": 1,
      "validatorEffectiveness": 98.46868397067385
    }
  ],
  "next": "/v0/eth/validators/effectiveness?indices=100&indices=101&groupBy=timeWindow&granularity=month&size=1&from=791&filterType=day",
  "page": {
    "filterType": "day",
    "granularity": "month",
    "size": 1
  },
  "total": 27
}
The Rated API enables the aggregation of all the metrics that live under effectiveness across an arbitrary number of validator indices or pubkeys, at the endpoint level. 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”)
toEnd 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
groupByTime window or validator; we either group by validator index or across time
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

Query Parameters

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

Response

Successful Response

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