Skip to main content
POST
💎 Owners

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
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi

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.

Required string length: 1 - 64
Example:

"lido csm"

range
Fixed Window · object

The window of beaconscore, 30d when not given. all_time is not supported and answers 400. Every window ends at the latest hourly count, so the validator counts and net_share are the same in every window.

sort_by
enum<string>
default:validator_count

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
Available options:
validator_count,
beaconscore,
net_share
Example:

"beaconscore"

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
cursor
string
default:""

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

page_size
integer
default:10

The number of items to return per page.

Required range: 1 <= x <= 10
operator
Id · object

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.

Response

Successful response.

Response containing the entities that match every filter, in the order sort_by and sort_order give.

data
object[]
required

The entities and, unless search is given, the Unknown row of the validators without an entity when there are any, sorted among them.

last_updated
integer | null
required

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.

Required range: x >= 0
range
object | null
required

The epochs beaconscore covers, the window up to the last epoch the hourly count included, which net_share takes the balances of. Null before the chain's first count, and when no validator has data in the window.

paging
object