๐ Builder Metadata
Returns the curated labels of a set of builders: one row per tenure in the beacon chainโs builder registry, with its builder index, public key, execution layer address and epochs, and the builder entity, sub-entity and kind that beaconcha.in curated for that address. A label is null when the address has none.
The labels name who signed a bid, the builder in the registry. A relay can bid under its own registry entry for payloads that other builders built; its rows then name the relay, with kind relay.
To label proposals, join the rows of v2/ethereum/builders/proposal-slots or v2/ethereum/validators/proposal-slots on execution_payload.builder_pubkey, and take the tenure whose deposit_epoch is at or before the proposalโs epoch and whose superseded_epoch is after it or null.
Builder entity labels may take a few days after a chainโs Glamsterdam hard fork to settle, while we observe how builders operate in the first days; until then most labels are null.
Results are paginated with a default and maximum page size of 10, newest deposit_epoch first.
Premium Endpoint: This endpoint requires a Scale or Enterprise plan.
Authorizations
Body
Select builders by one of these options. Every endpoint that uses this selector requires a Scale or Enterprise plan:
- builder_pubkey: One builder, by its public key, as in
execution_payload.builder_pubkey. The best way to follow one builder over time. - builder_index: The builder that holds this index now. To select the builder of a past slot, use that slot's
builder_pubkey. - builder_execution_address: Every builder that withdraws to this execution layer address. Use it for all the builders of one operator.
- builder_entity: Every builder that withdraws to an address that beaconcha.in curated under this name. Optionally include
builder_sub_entity. Matching is case-sensitive.
Note: When a builder exits and withdraws its whole balance, the chain gives its index to the next new builder, so one index can name different builders over time. Every option therefore resolves to builder public keys, and a proposal counts for a builder only from the epoch it took the index until the epoch the next builder took it. The builder registry exists from the Glamsterdam hard fork on. An option that matches no builder returns 404. A builder that matches but has nothing in the result returns an empty list or zero counts, not 404.
- Builder Public Key
- Builder Index
- ๐ Builder Execution Address
- ๐ Builder Entity
The Ethereum chain to query.
mainnet, hoodi Cursor value for pagination. See our pagination guide for more details.
The number of items to return per page.
1 <= x <= 10
