Skip to main content
GET
/
v0
/
eth
/
operators
Get Summaries
curl --request GET \
  --url https://api.rated.network/v0/eth/operators \
  --header 'Authorization: Bearer <token>'
{
  "page": {
    "from": 123,
    "to": 123,
    "size": 10,
    "granularity": "hour",
    "filterType": "hour"
  },
  "total": 1,
  "data": [
    {
      "id": "<string>",
      "idType": "depositAddress",
      "timeWindow": "1d",
      "validatorCount": 1,
      "avgCorrectness": 1,
      "avgInclusionDelay": 1,
      "avgUptime": 1,
      "avgValidatorEffectiveness": 1,
      "clientPercentages": [
        {
          "client": "<string>",
          "percentage": 1
        }
      ],
      "networkPenetration": 1,
      "relayerPercentages": [
        {
          "relayer": "<string>",
          "percentage": 1
        }
      ],
      "nodeOperatorCount": 1,
      "operatorTags": [
        {
          "name": "<string>",
          "path": "<string>",
          "idType": "depositAddress"
        }
      ],
      "displayName": "<string>",
      "aprPercentage": 123,
      "sumEndEpochBalance": 1,
      "sumEndEpochEffectiveBalance": 1
    }
  ],
  "next": "<string>"
}
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 Network Explorer. Here’s how to interpret the inputs required to operate it 👇
ParameterContext
windowThe time window of aggregation. You might ask for 1d, 7d, 30d or All-time data
idTypeThe type of entity class you would like returned. You might ask for pool, poolShare, nodeOperator, depositAddress or withdrawalAddress
sizeThe number of results included per page
parentIdSpecifying a pool or node operator so that the response is focused on the Pool sharesof said entity.
For an endpoint that returns the same information, but only for a specified entity––rather than a list of entities, see operator summary

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

Query Parameters

​
window
enum<string>
required
Available options:
1d,
7d,
30d,
all
​
poolType
enum<string>
default:all
Available options:
all,
cex,
lst
​
idType
enum<string>
default:depositAddress
Available options:
depositAddress,
withdrawalAddress,
nodeOperator,
pool,
poolShare,
entity,
validator,
privateSet
​
from
integer | null
​
size
integer | null
default:15
​
parentId
string | null
​
parentEntity
string | null
deprecated

Use parentId

Response

Successful Response

​
page
Page · object
required
​
total
integer
required
Required range: x >= 0
​
data
OperatorEffectivenessSummary · object[]
required
​
next
string | null
required