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.Use-case guides focus on choosing endpoints, sequencing requests, and turning responses into operational decisions.
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.
MEV Analysis
Measure relay bid timing, compare operators and validator sets, and investigate individual proposals.Introduction
Choose the right MEV timing endpoint and understand timing bands, histograms, and data freshness.
Compare MEV Timing
Benchmark daily entity behavior against the network and profile your validator sets.
Investigate a Block
Audit the winning bid, later alternatives, value left on the table, and full relay bid ladder.
Track Queues & Operations
Monitor network queues and plan validator operations.Introduction
Overview of the Queue APIs, the staking queues, and how to choose an endpoint.
Estimate Queue Wait Times
Turn queue lengths and churn rates into activation and exit ETAs.
Staking Inflows & Outflows
Measure pending ETH in transit — deposits awaiting activation and exits awaiting redemption.