Skip to main content

​
Overview

The Queue API provides information about network-wide queue statistics and estimated wait times. Use this to understand current chain demand, estimate activation times for new validators, and plan validator operations.
API Endpoint: This guide uses /api/v2/ethereum/queues for network-wide queue statistics. Per-validator queue tracking is coming soon.

​
Why Track Queues?

Estimate Activation Times

Understand how long new deposits will take to activate based on current queue length.

Customer Communication

Provide accurate ETAs to staking customers for deposits and withdrawals.

Chain Demand Insights

Monitor queue lengths to understand overall network staking demand.

Exit Planning

Plan validator exits based on current exit queue processing rate.

​
Network Queue Statistics

Get overall network queue lengths and processing rates: 
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/queues \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"chain": "mainnet"}'

​
Response

{
  "data": {
    "deposit_queue": {
      "deposit_count": 1250,
      "balance": "40000000000000000000000",
      "estimated_processed_at": 1736500000,
      "churn": "2048000000000000000000"
    },
    "exit_queue": {
      "validator_count": 450,
      "estimated_processed_at": 1736300000,
      "churn": "256000000000000000000"
    },
    "withdrawal_sweep": {
      "estimated_sweep_delay": {
        "epoch": 150,
        "ts": 57600
      }
    }
  }
}

​
Response Fields

​
Deposit Queue

FieldDescription
deposit_queue.deposit_countTotal deposits waiting (includes top-ups; not deduplicated by validator)
deposit_queue.balanceTotal ETH value in the deposit queue (in wei)
deposit_queue.estimated_processed_atEstimated Unix timestamp when the entire deposit queue will be processed
deposit_queue.churnETH processed per epoch (current churn limit, in wei)

​
Exit Queue

FieldDescription
exit_queue.validator_countNumber of validators waiting to exit
exit_queue.estimated_processed_atEstimated Unix timestamp when the entire exit queue will be processed
exit_queue.churnETH processed per epoch (current churn limit, in wei)

​
Withdrawal Sweep

FieldDescription
withdrawal_sweep.estimated_sweep_delay.epochCurrent sweep delay in epochs
withdrawal_sweep.estimated_sweep_delay.tsCurrent sweep delay in seconds
Sweep Delay: After becoming eligible for withdrawal, validators may wait up to ~10 days for the automatic sweep to process their balance. The sweep cycles through all validators sequentially.

​
Best Practices

Poll Periodically

Queue lengths change as validators enter and exit. Poll every 1-4 hours for accurate estimates.

Account for Variability

Queue processing speed varies with network conditions. Provide time ranges, not exact times.

Monitor Churn Rate

The churn rate determines how fast queues are processed. Track it to understand network capacity.

​
Coming Soon

Per-Validator Queue Tracking: A future API update will provide queue status for specific validators, including individual activation and exit ETAs. Stay tuned for updates.
For detailed API specifications, see the Network section in the V2 API Docs sidebar.