OBobol
Validators

Get the deposit status of a batch of validator pubkeys

Changed on

What our beacon node's head state holds for each pubkey: the validator registry entry (status, balances, activation and exit epochs), every deposit in the pending deposit queue (EIP-6110), each with its own withdrawal credentials, and the total queued in the pending partial withdrawal queue (EIP-7002). Returns one entry per distinct requested pubkey, in request order, including pubkeys with status new. Accepts up to 1000 pubkeys per request (96 hex characters, 0x prefix optional, case-insensitive). Amounts are wei decimal strings. Queued deposit signatures are verified in the background, each queue entry once; a queue-only pubkey whose deposits are not all verified yet has signaturesPending: true (retry for the complete answer). Any upstream failure fails the whole request so a partial answer can never read as new. Entries are cached per pubkey for one slot.

post/v1/validators/{network}/deposit-status

Request

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

Path parameters

networkstring required

The network to query validators on

Request body

pubkeysstring[] required

Validator BLS pubkeys (96 hex chars, 0x prefix optional). Max 1000 per request.

Example request

{
  "pubkeys": [
    "0x8021d0a2e39c261e29b0aa47a56e21df8a3a11b6bce1bfa621d403c95d3fbe0da4bd1c2a3af0a1b6bd9e0c4a5c2f0e11"
  ]
}

Response

Deposit status per requested pubkey

Example response

{
  "validators": [
    {
      "pubkey": "0x8021d0a2e39c261e29b0aa47a56e21df8a3a11b6bce1bfa621d403c95d3fbe0da4bd1c2a3af0a1b6bd9e0c4a5c2f0e11",
      "status": "active",
      "beaconStatus": "active_ongoing",
      "index": "123456",
      "balance": "32000123456000000000",
      "effectiveBalance": "32000000000000000000",
      "activationEpoch": "12345",
      "exitEpoch": "67890",
      "pendingPartialWithdrawals": "0",
      "withdrawalCredentials": "0x010000000000000000000000abc0000000000000000000000000000000000000",
      "pendingDeposits": [
        {
          "amount": "32000000000000000000",
          "withdrawalCredentials": "0x010000000000000000000000abc0000000000000000000000000000000000000",
          "signatureValid": true
        }
      ]
    }
  ]
}

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

    • info

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

  • ffbd09536a1aRevision changes
    • info

      endpoint added