GET
/
v0
/
polygon
/
validators
/
{validator_id}
/
effectiveness

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

Path Parameters

validator_id
integer
required

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

200
application/json
Successful Response
page
object
required
total
integer
required
Required range: x > 0
data
object[]
required
next
string | null