Overview

A series of endpoint that provide a high level overview of all the different pools, operators, withdrawal/deposit addresses and validator indexes that form the infrastructure layer of Ethereum

Entity Summaries

The Rated API enables users to query into key metrics of pre-materialized entities. This works pretty much as hinted by the Rated Explorer, but with a much higher degree of flexibility in terms of time-frames, and granularity in terms of metrics.

What do you mean by "pre-materialized entities"?

The shortest way to put it, in an Ethereum context, is "groups of validators bound together by agency". This could be:

1. a pool (e.g. Lido)

2. a node operator (e.g. Allnodes)

3. a fraction of a node operator's fleet that maps under a specific pool (e.g. Stakefish under Lido)

4. a group of validator indices mapped to a specific deposit address (e.g. 0xdd192...)

5. a group of validator indices mapped to a specific withdrawal address (e.g. 0xdd192...)

If you want to get your entity tracked on Rated, head to https://bit.ly/RatedPoolOnboarding to onboard as a pool or head to Self Report to onboard as a node operator.

Get summary stats on Pools, Operators and Addresses

This endpoint returns summary statistics for all the operators Rated has pre-materialized views on––commensurate to the output you might see on the Rated Explorer. Filter by entityType to view the stats for a specific type of entity i.e. by pools, operators and withdrawal/deposit addresses.

GET/v1/eth/entities/summaries

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/entities/summaries', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "type": "depositAddress",
      "id": "0xa40dfee99e1c85dc97fdc594b16a460717838703",
      "window": "1d",
      "name": "0xa40dfee99e1c85dc97fdc594b16a460717838703",
      "validatorCount": 37361,
      "avgValidatorEffectiveness": 0.07855633469653803,
      "networkPenetration": 0.07855633469653803,
      "clientPercentages": [
        {
          "client": "Prysm",
          "percentage": 0.5
        },
        {
          "client": "Lighthouse",
          "percentage": 0.3
        }
      ],
      "relayerPercentages": [
        {
          "relayer": "no_mev_boost",
          "percentage": 0.5
        },
        {
          "relayer": "bloxroute_regulated",
          "percentage": 0.3
        }
      ]
    }
  ]
}

---

Get summary stats on individual Pools, Operators and Addresses

This endpoint returns summary statistics for a specific pool,operator or withdrawal/deposit address that Rated has pre-materialized views on––commensurate to the output you might see on the Rated Explorer.

GET/v1/eth/entities/{entity_id}/summaries

Path parameters

entity_id*Entity Id

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/entities/{entity_id}/summaries', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "type": "depositAddress",
      "id": "0xa40dfee99e1c85dc97fdc594b16a460717838703",
      "window": "1d",
      "name": "0xa40dfee99e1c85dc97fdc594b16a460717838703",
      "validatorCount": 37361,
      "avgValidatorEffectiveness": 0.07855633469653803,
      "networkPenetration": 0.07855633469653803,
      "clientPercentages": [
        {
          "client": "Prysm",
          "percentage": 0.5
        },
        {
          "client": "Lighthouse",
          "percentage": 0.3
        }
      ],
      "relayerPercentages": [
        {
          "relayer": "no_mev_boost",
          "percentage": 0.5
        },
        {
          "relayer": "bloxroute_regulated",
          "percentage": 0.3
        }
      ]
    }
  ]
}

Validator Summaries

The validators class is the lowest order of aggregation that the Rated API supports.

What is a "validator"?

A validator is a virtual entity that lives on Ethereum and participates in the consensus of the Ethereum protocol. Validators are represented by a balance, public key, and other properties.

Get a list of validators

This endpoint returns an overview of all validators on the Beacon Chain with details on its activation, withdrawal and exit epochs.

GET/v1/eth/validators

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/validators', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "validator_index": 1,
      "validator_pubkey": "0xb44440543ceef8d77e065c70da15f7b731e56db5457571c465f025e032bbcd263a0990c8749b4ca6ff20d77004466666",
      "activation_epoch": 169000,
      "activation_eligibility_epoch": 171000,
      "exit_epoch": 172000,
      "withdrawable_epoch": 172256
    }
  ]
}

---

Get validator

This endpoint returns a single validator index on the Beacon Chain with details on its activation, withdrawal and exit epochs.

GET/v1/eth/validators/{validator_index_or_pubkey}

Path parameters

validator_index_or_pubkey*Validator Index Or Pubkey

integerstring

Header parameters

Response

200400

Successful Response

Body

application/json

validatorIndex*Validatorindex

validatorPubkey*Validatorpubkey

activationEpochActivationepoch

activationEligibilityEpochActivationeligibilityepoch

exitEpochExitepoch

withdrawableEpochWithdrawableepoch

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/validators/{validator_index_or_pubkey}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "validator_index": 1,
  "validator_pubkey": "0xb44440543ceef8d77e065c70da15f7b731e56db5457571c465f025e032bbcd263a0990c8749b4ca6ff20d77004466666",
  "activation_epoch": 169000,
  "activation_eligibility_epoch": 171000,
  "exit_epoch": 172000,
  "withdrawable_epoch": 172256
}