Returns a list of all configured statistics groups.

Response:

[
 {
 "id": 1,
 "name": "default",
 "bids_payload_work_mode": 2,
 "proposer_payload_work_mode": 2
 },
 ...
]

Returns configuration and status of a specific statistic group.

Path Parameters:

• statId – ID of the statistics group.

Returns aggregated builder bids statistics for the specified statistics group.

Query Parameters:

• slot (optional)
• fromSlot (optional)
• toSlot (optional)

Returns signed bid values for included relays in the statistics group.

Query Parameters:

• slot (optional)
• fromSlot (optional)
• toSlot (optional)

Returns a list of all configured relays with metadata and fetch/indexing statistics.

Response:

[
 {
 "id": 1,
 "pubkey": "0x...",
 "url": "https://relay.example.com",
 "requestLimitPerMinute": 300,
 "signedBidsStats": {
 "firstFetchedSlot": 123456,
 "lastFetchedSlot": 123999,
 "firstIndexedSlot": 123456,
 "lastIndexedSlot": 123980
 },
 "builderBlocksStats": {
 "firstFetchedSlot": 123456,
 "lastFetchedSlot": 123999,
 "firstIndexedSlot": 123456,
 "lastIndexedSlot": 123980
 }
 },
 ...
]

Returns detailed metadata and slot statistics for the specified relay.

Path Parameters:

• relayId – ID of the relay.

Returns signed bid data for all relays for a specific slot.

Query Parameters (optional):

• slot
• fromSlot
• toSlot

Returns signed bid data for a specific relay.

Path Parameters:

• relayId – ID of the relay.

Query Parameters (optional):

• slot
• fromSlot
• toSlot

These endpoints are recommended for dynamic configuration management.

Registers a new relay.

Request Body:

{
 "pubkey": "0x...",
 "url": "https://relay.example.com",
 "requestLimitPerMinute": 300
}

Updates configuration for an existing relay.

Creates a new statistics group.

Request Body:

{
 "name": "new_group",
 "bids_payload_work_mode": 2,
 "proposer_payload_work_mode": 1
}

Updates configuration for a statistics group.

Adds a relay to a statistics group with start slot settings.

Request Body:

{
 "relay_id": 1,
 "proposer_payload_start_slot": 123456,
 "bids_payload": 123456
}

Exposes system metrics in Prometheus-compatible format, including:

• API request usage per relay
• Fetch failures, retries
• Slots indexed/skipped
• Backlog per relay

Liveness and readiness check endpoint.