Sign in

v1

latestOpenAPI 3.0.42026-07-2233241175.9 KB
Entities

💎 Overview

Returns an overview of all entities with their validator count, BeaconScore, and net share.

Use case guide: Entity benchmarking explains how to rank entities and compare an operator with the network baseline.

Results can be sorted by beaconscore, net_share, validator_count, or sub_entity_count in ascending or descending order. By default, results are sorted by net_share in descending order.

Note: The underlying data is precomputed and updated hourly. all_time evaluation window is not supported for this endpoint.

Premium Endpoint: This endpoint requires a Scale or Enterprise plan.

Attribution Required: If you display BeaconScore data publicly, you must include appropriate attribution. See our BeaconScore License and License Materials for badges and usage guidelines.

post/api/v2/ethereum/entities

Request body

chain'mainnet' | 'hoodi'

The Ethereum chain to query.

cursorstring

Cursor value for pagination. See our pagination guide for more details.

page_sizeinteger

The number of items to return per page.

sort_by'beaconscore' | 'net_share' | 'validator_count' | 'sub_entity_count'

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
sort_order'asc' | 'desc'

The sort order for the results.

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

Response

Successful response.

last_updatedinteger required