💎 Owners
Returns the entities that own validators, such as staking providers and their sub-entities, with their validator count, BeaconScore®, and net share. Pass an entity’s id or path as entities.owner in the validator selector to select its validators.
The Unknown row holds the validators without an owner, with the same figures, sorted among the entities, and is left out when there are none. It has no id or path, and search leaves it out. With the top-level entities, those with empty ancestors, it counts every validator once, except after an entity is merged or removed, until the next hourly count.
With operator, it returns only the owners whose validators that operator runs, with the figures of those validators, and Unknown holds that operator’s validators without an owner.
Results can be sorted by validator_count, beaconscore, or net_share in ascending or descending order. By default, results are sorted by validator_count in descending order.
Note: The underlying data is precomputed and updated hourly: last_updated gives when the page’s figures were counted, and range the epochs they cover. A count can land while you page through the results: the next page then sorts by the new figures, so an entity can appear twice or be missed. When last_updated changes between two pages, start again without a cursor. 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.
Authorizations
Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.
Body
Lists the entities whose name, or name before a rename, starts with this text, ignoring case. Ignoring spaces and punctuation as well, it also matches the start of an entity's path read with a space for each / (Lido CSM finds lido/csm), of the path's last segment, and of a whale's address (0x8e60 finds Whale_0x8e60…). The Unknown row is left out.
1 - 64"lido csm"
The field to order entities by, then by path. Entities without a value come last in either order.
validator_count: by number of validators (default)beaconscore: by BeaconScore®net_share: by share of the network's stake
validator_count, beaconscore, net_share "beaconscore"
Cursor value for pagination. See our pagination guide for more details.
Lists the owners that share validators with this operator. Each listed owner's validator_count, beaconscore and net_share then cover only the shared validators, and its direct_validator_count is null. Unknown then covers the operator's validators without an owner, and is left out when there are none. A merged operator lists those of the entity it was merged into. Any entity other than an operator answers 404.
- Id
- Path
Response
Successful response.
Response containing the entities that match every filter, in the order sort_by and sort_order give.
Unix timestamp of the hourly count behind this page's validator counts, beaconscore and net_share. When it changes between two pages, a count landed in between, and the later page sorts by its new figures, so start again without a cursor. Null before the chain's first count.
x >= 0
