Skip to main content
GET
/
v0
/
eth
/
validators
/
{validator_index_or_pubkey}
/
apr
Get Apr
curl --request GET \
  --url https://api.rated.network/v0/eth/validators/{validator_index_or_pubkey}/apr \
  --header 'Authorization: Bearer <token>'
{
  "id": 1,
  "idType": "depositAddress",
  "timeWindow": "1d",
  "aprType": "backward",
  "percentage": 123,
  "percentageConsensus": 123,
  "percentageExecution": 123,
  "activeStake": 123,
  "activeValidators": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.rated.network/llms.txt

Use this file to discover all available pages before exploring further.

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>
default:mainnet
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>
default:backward
Available options:
backward,
forward

Response

Successful Response

​
id
integer
required
Required range: x >= 0
​
idType
enum<string>
required
Available options:
depositAddress,
withdrawalAddress,
nodeOperator,
pool,
poolShare,
entity,
validator,
privateSet
​
timeWindow
enum<string>
required
Available options:
1d,
7d,
30d,
all
​
aprType
enum<string>
required
Available options:
backward,
forward
​
percentage
number
required
​
percentageConsensus
number
required
​
percentageExecution
number
required
​
activeStake
number
required
​
activeValidators
integer
required
Required range: x >= 0