OBobol
Fee Recipient

Fetch partial fee recipient registrations

Changed on

Returns builder registration status for validators in a cluster. For each validator, returns at most two registrations: the latest one that reached quorum (quorum: true) and the latest one still collecting signatures (quorum: false). Validators with no registration data are omitted. Optionally pass an array of pubkeys in the request body to filter results.

post/v1/fee_recipient/{lockHash}

Request

  • Base URL
    https://api.obol.tech
  • Auth
    none declared

Path parameters

lockHashstring required
Example:0x1234abcd...

The cluster lock hash.

Request body

pubkeysstring[]

Optional list of validator pubkeys to filter by. If omitted or empty, returns all validators with registrations.

Example request

{
  "pubkeys": [
    "0xdeadbeef...",
    "0xcafebabe..."
  ]
}

Response

Per validator: at most 2 builder registrations (latest with quorum: true, latest with quorum: false). Each registration includes the signed message, partial signatures, and a quorum boolean. Pubkeys returned without 0x prefix.

Changes

  • c545dd14c211Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

  • 2cce0cd75371Revision changes
    • info

      added the non-success response with the status