GET
/
v1
/
eth
/
validators
/
{validator_index_or_pubkey}
/
aprs

This endpoint is available only to annual commitment and custom Enterprise plans. Get in touch with hello@rated.network to learn more.

This endpoint returns historical data on the returns of a validator index or pubkey. What’s really exciting about this one, is the ability to dig deep into the components of the aggregate return (e.g. returned earned on the execution layer vs the consensus layer etc).

window refers to the time window of the aggregation, with 1d, 7d, 30d and all being the supported values.

A validator must be active throughout the time window for the value to be produced. For all time the last 90 days are considered.

Headers

X-Rated-Network
enum<string>
Available options:
mainnet,
holesky

Path Parameters

validator_index_or_pubkey
required
Required range: x > 0

Query Parameters

limit
integer
default:
10

The number of results returned per page

offset
integer
default:
0

The number of results to skip before starting to return

window
enum<string> | null

The time window for the APR calculation

Available options:
1d,
7d,
30d,
all

Response

200
application/json
Successful Response
previous
string | null
required
next
string | null
required
pages
integer
required
Required range: x > 0
results
object[]
required