Skip to main content
GET
/
v0
/
polygon
/
validators
/
{validator_id}
/
effectiveness
Validator Checkpoint Effectiveness
curl --request GET \
  --url https://api.rated.network/v0/polygon/validators/{validator_id}/effectiveness \
  --header 'Authorization: Bearer <token>'
{
  "page": {
    "from": 123,
    "to": 123,
    "granularity": "checkpoint",
    "size": 1
  },
  "total": 1,
  "data": [
    {
      "validatorId": 1,
      "granularity": "checkpoint",
      "fromCheckpoint": 1,
      "toCheckpoint": 1,
      "checkpointSignatureDuties": 1,
      "checkpointSignatures": 1,
      "checkpointProposalDuties": 1,
      "checkpointProposals": 1,
      "borProposalDuties": 1,
      "borProposals": 1,
      "checkpointSignatureRewards": "<string>",
      "selfSigningRewards": "<string>",
      "distributedRewards": "<string>",
      "commissionRewards": "<string>",
      "delegatorRewards": "<string>",
      "missedCheckpointSignatureRewards": "<string>",
      "missedSelfSigningRewards": "<string>",
      "missedDistributedRewards": "<string>",
      "missedCommissionRewards": "<string>",
      "missedDelegatorRewards": "<string>",
      "priorityFees": 1,
      "mevRewards": 1,
      "totalStake": "<string>",
      "selfStake": "<string>",
      "delegatedStake": "<string>",
      "commissionRate": "<string>",
      "delegatorCount": 1,
      "borProposerEffectiveness": 1,
      "checkpointSignatureEffectiveness": 1,
      "checkpointProposerEffectiveness": 1,
      "effectiveness": 1,
      "fromDate": "2023-12-25",
      "toDate": "2023-12-25",
      "checkpointProposalRewards": "<string>",
      "missedCheckpointProposalRewards": "<string>"
    }
  ],
  "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 all the useful information you will ever need on the historical performance of a single validator. This includes rewards (checkpoint signings, proposals, Bor proposals), performance (effectiveness and its components), stake distribution, and so much more. For a glossary of the variables returned, see effectiveness. Here’s how to interpret the inputs required to operate it:
ParameterContext
fromStarting checkpoint (integer, e.g. 52922) or UTC date (e.g. from=“2023-10-31”)
granularityThe size of time increments you are looking to query. Can be checkpoint or day
sizeThe number of results included per page

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
validator_id
integer
required
Required range: x >= 0

Query Parameters

​
from
any | null

The starting checkpoint or date (UTC) to return. For example, 41100 or 2021-01-01.

​
granularity
enum<string> | null

Checkpoint or UTC day

Available options:
checkpoint,
day
​
size
integer
default:15

Response

Successful Response

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