Validators APR

GET /v0/eth/validators/{validator_index_or_pubkey}/apr

Get Apr

cURL

curl --request GET \
  --url https://api.rated.network/v0/eth/validators/{validator_index_or_pubkey}/apr \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 1,
  "percentage": 123,
  "percentageConsensus": 123,
  "percentageExecution": 123,
  "activeStake": 123,
  "activeValidators": 1
}

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 · integer string · 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

200

application/json

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