Skip to main content
POST
💎 Overview

Authorizations

Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
range
Fixed Window · object
required
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi
cursor
string
default:""

Opaque continuation token from a previous response. For machine metrics this token stores series-specific continuation state for system_metrics, validator_metrics, and node_metrics rather than a single shared list position.

page_size
integer
default:10

Number of items to return per metric array. Defaults to 10 when omitted.

Required range: 1 <= x <= 10
sort_by
enum<string>
default:net_share

The field to sort entities by.

  • beaconscore: Sort by BeaconScore (validator efficiency)
  • net_share: Sort by network share (default)
  • validator_count: Sort by number of validators
  • sub_entity_count: Sort by number of sub-entities
Available options:
beaconscore,
net_share,
validator_count,
sub_entity_count
sort_order
enum<string>
default:desc

The sort order for the results.

  • asc: Ascending order (lowest first)
  • desc: Descending order (highest first, default)
Available options:
asc,
desc

Response

Successful response.

Response containing an overview of entities with their validator count, BeaconScore, and net share.

data
object[]
required
last_updated
integer
required

Unix timestamp indicating when the entities data was last computed. The underlying data is precomputed and updated hourly.

Required range: x >= 0
range
object
required

The time span actually covered by the returned results — from the first to the last matching data point — specified in slots, epochs, and Unix timestamps.

This reflects the data that was found, not the range that was queried. When no data is found, it falls back to the requested range, or to the full available history if no range was given.

paging
object