Skip to main content
GET
Get Effectiveness Aggregation
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 👇

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

Query Parameters

pubkeys
string[] | null
indices
integer[] | null
Required range: x >= 0
from
Required range: x >= 0
to
Required range: x >= 0
filterType
enum<string>
default:day
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>
default:validator
Available options:
timeWindow,
validator
include
string[] | null

Response

Successful Response

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