Aggregating validator indices

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
}

GET

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 👇

Parameter	Context
`filterType`	day and datetime
`from`	Start day (integer) or datetime (e.g. from=“2022-12-01”)
`to`	End day (integer) or datetime (e.g. from=“2022-12-01”)
`granularity`	The size of time increments you are looking to query. Can be `day` / `week` / `month` / `quarter` / `year`
`size`	The number of results included per page
`groupBy`	Time window or validator; we either group by validator index or across time
`include`	A 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

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

PaginatedValidatorEffectivenessData
PaginatedValidatorEffectivenessAggregation

page

Page · object

required

Show child attributes

page.from

page.to

page.size

integer

default:10

page.granularity

enum<string> | null

Available options:

hour,

day,

week,

month,

quarter,

year,

all

page.filterType

enum<string> | null

Available options:

hour,

day,

datetime

total

integer

required

Required range: x >= 0

data

ValidatorEffectivenessData · object[]

required

Show child attributes

data.totalAttestations

integer | null

required

Required range: x >= 0

data.totalUniqueAttestations

integer | null

required

Required range: x >= 0

data.sumCorrectHead

integer | null

required

Required range: x >= 0

data.sumCorrectTarget

integer | null

required

Required range: x >= 0

data.avgCorrectness

number | null

required

Required range: x >= 0

data.totalAttestationAssignments

integer | null

required

Required range: x >= 0

data.avgInclusionDelay

number | null

required

Required range: x >= 0

data.sumInclusionDelay

number | null

required

Required range: x >= 0

data.uptime

number | null

required

Required range: x >= 0

data.attesterEffectiveness

number | null

required

Required range: x >= 0

data.proposedCount

integer | null

required

Required range: x >= 0

data.proposerDutiesCount

integer | null

required

Required range: x >= 0

data.proposerEffectiveness

number | null

required

Required range: x >= 0

data.slashesCollected

integer | null

required

Required range: x >= 0

data.slashesReceived

integer | null

required

Required range: x >= 0

data.earnings

integer | null

required

data.syncSignatureCount

integer | null

required

Required range: x >= 0

data.validatorEffectiveness

number | null

required

Required range: x >= 0

data.estimatedRewards

integer | null

required

data.estimatedPenalties

integer | null

required

data.sumPriorityFees

integer | null

required

Required range: x >= 0

data.sumBaselineMev

integer | null

required

data.sumMissedExecutionRewards

integer | null

required

data.sumConsensusBlockRewards

integer | null

required

data.sumMissedConsensusBlockRewards

integer | null

required

data.sumAllRewards

integer | null

required

data.sumCorrectSource

integer | null

required

Required range: x >= 0

data.sumMissedSyncSignatures

integer | null

required

Required range: x >= 0

data.sumSyncCommitteePenalties

number | null

required

data.sumLateSourceVotes

integer | null

required

Required range: x >= 0

data.sumWrongTargetVotes

integer | null

required

Required range: x >= 0

data.sumLateTargetVotes

integer | null

required

Required range: x >= 0

data.sumWrongTargetPenalties

number | null

required

data.sumLateTargetPenalties

number | null

required

data.sumMissedAttestations

integer | null

required

Required range: x >= 0

data.sumMissedAttestationPenalties

number | null

required

data.sumWrongHeadVotes

integer | null

required

Required range: x >= 0

data.sumWrongHeadPenalties

number | null

required

data.sumAttestationRewards

number | null

required

Required range: x >= 0

data.sumLateSourcePenalties

number | null

required

data.executionProposedEmptyCount

integer | null

required

Required range: x >= 0

data.sumMissedAttestationRewards

number | null

required

Required range: x >= 0

data.sumMissedSyncCommitteeRewards

number | null

required

Required range: x >= 0

data.sumExternallySourcedExecutionRewards

integer | null

required

data.startEpoch

integer

required

Required range: x >= 0

data.endEpoch

integer

required

Required range: x >= 0

data.hour

integer | null

Required range: x >= 0

data.day

integer | null

Required range: x >= 0

data.startDay

integer | null

Required range: x >= 0

data.endDay

integer | null

Required range: x >= 0

string | null

required

Get Effectiveness Validator metadata [single keys]

⌘I

Getting started

Rated API

Endpoints

Glossary

Guides

Tools

Authorizations

Headers

Query Parameters

Response