Skip to main content
GET
/
v0
/
eth
/
operators
/
{operator_id}
/
effectiveness
Get Effectiveness
curl --request GET \
  --url https://api.rated.network/v0/eth/operators/{operator_id}/effectiveness \
  --header 'Authorization: Bearer <token>'
{
  "page": {
    "from": 123,
    "to": 123,
    "size": 10
  },
  "total": 1,
  "data": [
    {
      "id": "<string>",
      "validatorCount": 1,
      "avgInclusionDelay": 1,
      "avgUptime": 1,
      "avgCorrectness": 1,
      "avgProposerEffectiveness": 1,
      "avgValidatorEffectiveness": 1,
      "totalUniqueAttestations": 1,
      "sumCorrectHead": 1,
      "sumCorrectTarget": 1,
      "sumInclusionDelay": 1,
      "sumProposedCount": 1,
      "sumProposerDutiesCount": 1,
      "slashesCollected": 1,
      "slashesReceived": 1,
      "sumEarnings": 123,
      "sumEstimatedRewards": 123,
      "sumEstimatedPenalties": 123,
      "networkPenetration": 1,
      "sumPriorityFees": 1,
      "sumBaselineMev": 123,
      "sumMissedExecutionRewards": 123,
      "sumConsensusBlockRewards": 123,
      "sumMissedConsensusBlockRewards": 123,
      "sumAllRewards": 123,
      "sumCorrectSource": 1,
      "avgAttesterEffectiveness": 1,
      "sumMissedSyncSignatures": 1,
      "sumSyncCommitteePenalties": 123,
      "sumLateSourceVotes": 1,
      "sumWrongTargetVotes": 1,
      "sumLateTargetVotes": 1,
      "sumWrongTargetPenalties": 123,
      "sumLateTargetPenalties": 123,
      "sumMissedAttestations": 1,
      "sumMissedAttestationPenalties": 123,
      "sumWrongHeadVotes": 1,
      "sumWrongHeadPenalties": 123,
      "sumAttestationRewards": 1,
      "sumLateSourcePenalties": 123,
      "sumExecutionProposedEmptyCount": 1,
      "sumMissedAttestationRewards": 1,
      "sumMissedSyncCommitteeRewards": 1,
      "sumExternallySourcedExecutionRewards": 123,
      "sumEndEpochBalance": 1,
      "sumEndEpochEffectiveBalance": 1,
      "startEpoch": 1,
      "endEpoch": 1,
      "hour": 1,
      "day": 1,
      "startDay": 1,
      "endDay": 1
    }
  ],
  "next": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.rated.network/llms.txt

Use this file to discover all available pages before exploring further.

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 👇
ParameterContext
filterTypehour, day and datetime
fromStart 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
idTypeThe 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.
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

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:10
​
granularity
enum<string>
default:day
Available options:
hour,
day,
week,
month,
quarter,
year,
all
​
filterType
enum<string>
Available options:
hour,
day,
datetime
​
include
string[] | null

Response

Successful Response

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