Get Effectiveness

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 👇

Parameter	Context
`filterType`	day and datetime
`from`	Start 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
`include`	A list of field names. Use it to filter the specific fields you want in the response payload

Headers

X-Rated-Network

enum<string>

Available options:

mainnet,

holesky

Path Parameters

validator_index_or_pubkey

required

Required range: x > 0

Query Parameters

from

Required range: x > 0

size

integer

default:

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

page

object

required

total

integer

required

Required range: x > 0

data

object[]

required

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.validatorIndex

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

Getting started

Rated API

Endpoints

Glossary

Guides

Tools

Headers

Path Parameters

Query Parameters

Response