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.
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.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 |
| 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 |