GET
/
v0
/
eth
/
validators
/
effectiveness

The Rated API enables the aggregation of all the metrics that live under effectiveness across an arbitrary number of validator indices or pubkeys, at the endpoint level.

Here’s how to interpret the inputs required to operate it πŸ‘‡

ParameterContext
filterTypeday and datetime
fromStart day (integer) or datetime (e.g. from=β€œ2022-12-01”)
toEnd 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
groupByTime window or validator; we either group by validator index or across time
includeA 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

Query Parameters

pubkeys
string[] | null
indices
integer[] | null
from
Required range: x > 0
to
Required range: x > 0
filterType
enum<string>
Available options:
hour,
day,
datetime
size
integer
default:
10
Required range: x > 0
granularity
enum<string> | null
Available options:
day,
week,
month,
quarter,
year,
all
groupBy
enum<string>
Available options:
timeWindow,
validator
include
string[] | null

Response

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