GET
/
v0
/
eth
/
validators
/
{validator_index_or_pubkey}
/
apr
curl --request GET \
  --url https://api.rated.network/v0/eth/validators/{validator_index_or_pubkey}/apr \
  --header 'Authorization: Bearer <token>'
{
  "activeStake": 4823520000000000,
  "activeValidators": 150735,
  "aprType": "backward",
  "idType": "validator",
  "percentage": 5.35,
  "percentageConsensus": 4.04,
  "percentageExecution": 1.31,
  "timeWindow": "all",
  "validatorIndex": 1000
}

This endpoint returns historical data on the returns of a validator index. 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.

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

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>
Available options:
mainnet,
hoodi,
holesky

Path Parameters

​
validator_index_or_pubkey
required
Required range: x >= 0

Query Parameters

​
window
enum<string>
required
Available options:
1d,
7d,
30d,
all
​
apr_type
enum<string>
Available options:
backward,
forward

Response

200
application/json

Successful Response

The response is of type object.