v1

latestOpenAPI 3.0.42026-07-2233241175.9 KB
Entities

πŸ’Ž Sub Entities

Returns an overview of all sub-entities associated with a given entity, including their validator count, BeaconScore, and net share.

Use case guide: Entity benchmarking explains how to drill from a public entity into its sub-entities and compare them with the network.

Results can be sorted by beaconscore, net_share, or validator_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/entity/sub-entities

Request body

chain'mainnet' | 'hoodi'

The Ethereum chain to query.

entitystring required

The name of the entity (e.g., "Lido", "Coinbase").

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'

The field to sort sub-entities by.

  • beaconscore: Sort by BeaconScore (validator efficiency)
  • net_share: Sort by network share (default)
  • validator_count: Sort by number of validators
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