Overview
This section provides step-by-step guides for common validator operations. Each guide includes code examples, best practices, and links to the relevant API endpoints.Calculate Validator Rewards
Track and calculate validator earnings across consensus and execution layers.Introduction
Overview of reward endpoints, when to use aggregate vs. list APIs, and quick start examples.
Custom Range Rewards
Calculate rewards for any date range by iterating through epochs.
Tax Year Calculations
Get per-epoch rewards for tax reporting with fiat conversion guidance.
Dashboard Private Sets
Organize validators into groups and query by
dashboard_id or group_id.Epoch & Time Zones
Convert between epochs, timestamps, and local time zones.
Monitor Validator Performance
Track efficiency, identify issues, and measure returns.BeaconScore Overview
Understand BeaconScore components and how to fetch performance metrics.
Rank & Compare Entities
Rank staking entities by BeaconScore, validator count, network share, and distribution.
Benchmark Entity vs Network
Benchmark a selected entity against the network baseline and inspect sub-entities.
Private Entity Benchmarking
Use dashboards as private entity definitions and benchmark them against network performance.
Embed BeaconScore
Integrate BeaconScore into your product with attribution guidelines.
Analyze Missed Rewards
Identify lost rewards by duty type and quantify downtime costs.
APY & ROI Metrics
Calculate annual returns with execution/consensus layer breakdown.
Track Queues & Operations
Monitor network queues and plan validator operations.Queue Tracking
Monitor activation, exit, and withdrawal queues with estimated wait times.
Quick Reference
| Use Case | Best Endpoint | Description |
|---|---|---|
| Daily/weekly rewards summary | rewards-aggregate | Rolling periods (24h, 7d, 30d, 90d) |
| Tax reporting | rewards-list | Per-epoch data for fiat conversion |
| Performance comparison | performance-aggregate | BeaconScore across groups |
| Rank entities | entities | Compare staking entities by BeaconScore, size, and network share |
| Benchmark entity vs network | entities, performance-aggregate | Compare selected providers to network baseline and drill into sub-entities |
| Benchmark private entities | validators/performance-aggregate, performance-aggregate | Use dashboard/group sets as private entities and compare against network |
| Missed rewards analysis | rewards-list | Per-epoch missed reward breakdown |
| APY/ROI calculation | apy-roi | Annualized return metrics |
| Queue wait times | ethereum/queues | Network-wide queue statistics |