Operator effectiveness

This endpoint returns a bunch of useful information on the historical performance of a single operator. 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`	hour, 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
`idType`	The type of entity class you would like returned. You might ask for `pool`, `poolShare`, `nodeOperator`, `depositAddress`, or `withdrawalAddress`. Note: it is optional and can be inferred automatically for pools, pool shares and node operators. It defaults to `depositAddress` if it is missing and an address is provided.
`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

operator_id

string

required

Query Parameters

idType

enum<string> | null

Available options:

depositAddress,

withdrawalAddress,

nodeOperator,

pool,

poolShare,

entity,

validator,

privateSet

from

Required range: x > 0

size

integer

default:

granularity

enum<string>

Available options:

hour,

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

string

required

data.idType

enum<string>

required

Available options:

depositAddress,

withdrawalAddress,

nodeOperator,

pool,

poolShare,

entity,

validator,

privateSet

data.validatorCount

integer | null

required

Required range: x > 0

data.avgInclusionDelay

number | null

required

Required range: x > 0

data.avgUptime

number | null

required

Required range: x > 0

data.avgCorrectness

number | null

required

Required range: x > 0

data.avgProposerEffectiveness

number | null

required

Required range: x > 0

data.avgValidatorEffectiveness

number | 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.sumInclusionDelay

number | null

required

Required range: x > 0

data.sumProposedCount

integer | null

required

Required range: x > 0

data.sumProposerDutiesCount

integer | 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.sumEarnings

integer | null

required

data.sumEstimatedRewards

integer | null

required

data.sumEstimatedPenalties

integer | null

required

data.networkPenetration

number | null

required

Required range: x > 0

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

number | 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.sumExecutionProposedEmptyCount

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