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>
Available options:
mainnet,
hoodi,
holesky

Query Parameters

​
pubkeys
string[] | null
​
indices
integer[] | null
​
from
Required range: x >= 0
​
to
Required range: x >= 0
​
filterType
enum<string>
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>
Available options:
timeWindow,
validator
​
include
string[] | null

Response

200
application/json

Successful Response

The response is of type object.