Validator Queues

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

validator

Indexes/Public Keys · object

required

Free selectors available to all users:

validator_identifiers: One or more validator indices or public keys to filter by.
dashboard_id: Your beaconcha.in dashboard ID (requires a free account).

Premium selectors for Scale & Enterprise plans (https://beaconcha.in/pricing):

withdrawal: The validator's withdrawal credential or the Ethereum wallet address used for withdrawals.
deposit_address: The Ethereum wallet address used for the validator's deposit.

Indexes/Public Keys
Dashboard
💎 Deposit
💎 Withdrawal

Show child attributes

validator.validator_identifiers

(integer | string)[]

required

An array containing either validator indices or public keys. Index and public key can be mixed in the same array.

Premium users can include up to 100 entries; free users are limited to 20.

Required array length: 1 - 100 elements

Validator Index

Required range: x >= 0

chain

enum<string>

default:mainnet

The Ethereum chain to query.

Available options:

mainnet,

hoodi

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

Response

Successful response.

Response containing basic information about the queue.

data

object[]

required

Show child attributes

data.validator

object

required

Show child attributes

data.validator.index

integer

Validator Index

Required range: x >= 0

data.validator.public_key

string

Public key of a validator

data.finality

enum<string>

required

Indicates the finality status of the data provided.

Finalized data cannot be changed without slashing at least one-third of all validators, providing strong economic guarantees.
Data marked as not_finalized does not have this guarantee and may still change.

Available options:

not_finalized

data.deposit

object

Show child attributes

data.deposit.next

object

Details for the next in line pending deposit/top-up.

Show child attributes

data.deposit.next.amount

string

required

Amount of the next pending action in wei.

data.deposit.next.estimated_processed

object

required

Estimated epoch when this action will be processed.

Show child attributes

data.deposit.next.estimated_processed.epoch

integer

required

Epoch number

Required range: x >= 0

data.deposit.next.estimated_processed.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.deposit.all

object

Details for all pending deposits/top-ups combined.

Show child attributes

data.deposit.all.amount

string

required

Total amount of all pending actions in wei.

data.deposit.all.estimated_processed

object

required

Estimated epoch when all actions will be processed.

Show child attributes

data.deposit.all.estimated_processed.epoch

integer

required

Epoch number

Required range: x >= 0

data.deposit.all.estimated_processed.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.deposit.estimated_activation

object

Estimated time and epoch when a newly deposited validator will become active. Null for top-ups, or if balance+pending deposits < 32 ETH.

Show child attributes

data.deposit.estimated_activation.epoch

integer

required

Epoch number

Required range: x >= 0

data.deposit.estimated_activation.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.exit

object

Show child attributes

data.exit.estimated_exit

object

required

Estimated time/epoch when the validator will exit the active set.

Show child attributes

data.exit.estimated_exit.epoch

integer

required

Epoch number

Required range: x >= 0

data.exit.estimated_exit.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.exit.estimated_last_duty

object

required

Estimated time/epoch of the validator's last duty. Usually aligns with estimated_exit, but rare sync-committee assignments may happen afterward.

Show child attributes

data.exit.estimated_last_duty.epoch

integer

required

Epoch number

Required range: x >= 0

data.exit.estimated_last_duty.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.exit.estimated_eligible_withdrawal

object

required

Estimated epoch and timestamp when the validator becomes eligible for withdrawal (at least 256 epochs after exit).

Eligibility marks the earliest point at which the validator can be withdrawn. The actual withdrawal may, in the worst case, occur up to ~10 days later due to the automatic sweeping process (sweep delay). For the estimated time when the balance will actually be withdrawn, see estimated_withdrawal below.

Show child attributes

data.exit.estimated_eligible_withdrawal.epoch

integer

required

Epoch number

Required range: x >= 0

data.exit.estimated_eligible_withdrawal.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.exit.estimated_withdrawal

object

required

Estimated epoch when the validator’s balance will actually be withdrawn. Accounts for the sweep delay after eligibility.

Show child attributes

data.exit.estimated_withdrawal.epoch

integer

required

Epoch number

Required range: x >= 0

data.exit.estimated_withdrawal.timestamp

integer

required

Unix timestamp

Required range: x >= 0

data.withdrawal

object

Information about the validator's automatic and manual withdrawals.

Withdrawals can be automatic (auto-sweep) or manual (initiated by the validator owner). A validator may have either, both, or neither type of pending withdrawals.

Show child attributes

data.withdrawal.withdrawal_sweep

object

required

Automatic withdrawals occur periodically for exited validators or when balance exceeds the maximum effective balance.

Will be null for validators that are not eligible for auto-sweeps at the moment.

Show child attributes

data.withdrawal.withdrawal_sweep.next

object

required

Details of the next in line scheduled automatic withdrawal (sweep/skimming).

Show child attributes

data.withdrawal.withdrawal_sweep.next.estimated_amount

string

required

Estimated withdrawal amount in the next sweep.

data.withdrawal.withdrawal_sweep.next.estimated_withdrawal

object

required

Estimated epoch when next sweep occurs.

Show child attributes

data.withdrawal.withdrawal_sweep.next.estimated_withdrawal.epoch

integer

required

Epoch number

Required range: x >= 0

data.withdrawal.withdrawal_sweep.next.estimated_withdrawal.timestamp

integer

required

Unix timestamp

Required range: x >= 0

Introduction

V2 API Docs

V1 API Docs

Authorizations

Body

Response