> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Practical guides for common validator operations using the beaconcha.in V2 API

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

<Note>
  Use-case guides focus on choosing endpoints, sequencing requests, and turning responses into operational decisions.
</Note>

***

## Calculate Validator Rewards

Track and calculate validator earnings across consensus and execution layers.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/use-cases/rewards-introduction">
    Overview of reward endpoints, when to use aggregate vs. list APIs, and quick start examples.
  </Card>

  <Card title="Custom Range Rewards" icon="calendar-range" href="/use-cases/rewards-custom-range">
    Calculate rewards for any date range by iterating through epochs.
  </Card>

  <Card title="Tax Year Calculations" icon="calculator" href="/use-cases/rewards-tax-calculations">
    Get per-epoch rewards for tax reporting with fiat conversion guidance.
  </Card>

  <Card title="Dashboard Private Sets" icon="table-columns" href="/use-cases/rewards-dashboard-private-sets">
    Organize validators into groups and query by `dashboard_id` or `group_id`.
  </Card>

  <Card title="Epoch & Time Zones" icon="clock" href="/use-cases/rewards-epoch-conversion">
    Convert between epochs, timestamps, and local time zones.
  </Card>
</CardGroup>

***

## Monitor Validator Performance

Track efficiency, identify issues, and measure returns.

<CardGroup cols={2}>
  <Card title="BeaconScore Overview" icon="gauge-high" href="/use-cases/performance-introduction">
    Understand BeaconScore components and how to fetch performance metrics.
  </Card>

  <Card title="Rank & Compare Entities" icon="ranking-star" href="/use-cases/rank-and-compare-entities">
    Rank staking entities by BeaconScore, validator count, network share, and distribution.
  </Card>

  <Card title="Benchmark Entity vs Network" icon="scale-balanced" href="/use-cases/benchmark-entity-vs-network">
    Benchmark a selected entity against the network baseline and inspect sub-entities.
  </Card>

  <Card title="Private Entity Benchmarking" icon="tags" href="/use-cases/private-entity-benchmarking-with-dashboard">
    Use dashboards as private entity definitions and benchmark them against network performance.
  </Card>

  <Card title="Embed BeaconScore" icon="code" href="/use-cases/embed-beaconscore">
    Integrate BeaconScore into your product with attribution guidelines.
  </Card>

  <Card title="Analyze Missed Rewards" icon="chart-pie" href="/use-cases/missed-rewards">
    Identify lost rewards by duty type and quantify downtime costs.
  </Card>

  <Card title="APY & ROI Metrics" icon="percent" href="/use-cases/apy-roi">
    Calculate annual returns with execution/consensus layer breakdown.
  </Card>
</CardGroup>

***

## MEV Analysis

Measure relay bid timing, compare operators and validator sets, and investigate individual proposals.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/use-cases/mev-analysis-introduction">
    Choose the right MEV timing endpoint and understand timing bands, histograms, and data freshness.
  </Card>

  <Card title="Compare MEV Timing" icon="scale-balanced" href="/use-cases/compare-mev-timing">
    Benchmark daily entity behavior against the network and profile your validator sets.
  </Card>

  <Card title="Investigate a Block" icon="magnifying-glass" href="/use-cases/investigate-mev-block">
    Audit the winning bid, later alternatives, value left on the table, and full relay bid ladder.
  </Card>
</CardGroup>

***

## Track Queues & Operations

Monitor network queues and plan validator operations.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/use-cases/queue-tracking">
    Overview of the Queue APIs, the staking queues, and how to choose an endpoint.
  </Card>

  <Card title="Estimate Queue Wait Times" icon="clock-rotate-left" href="/use-cases/queue-wait-times">
    Turn queue lengths and churn rates into activation and exit ETAs.
  </Card>

  <Card title="Staking Inflows & Outflows" icon="arrow-right-arrow-left" href="/use-cases/staking-inflows-outflows">
    Measure pending ETH in transit — deposits awaiting activation and exits awaiting redemption.
  </Card>
</CardGroup>

***

## 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                                                  |
| Network MEV timing trends           | `ethereum/mev-timing`                                       | Daily timing breakdown and histogram                                       |
| Entity and validator MEV comparison | `entity/mev-timing`, `validators/mev-timing-aggregate`      | Daily entity trends and 180-day validator profiles                         |
| Block MEV investigation             | `block/mev-timing`, `block/mev-bids`                        | Winning bid outcome and complete relay bid ladder                          |
| Queue wait times                    | `ethereum/queues`                                           | Network-wide queue statistics                                              |
| Pending ETH in transit              | `ethereum/queues`, `validators/queues`                      | Deposit, exit, and withdrawal queue balances with ETAs                     |

<Tip>
  Each guide includes Python and JavaScript code examples. Look for the **API Endpoint** note at the top of each document to find the relevant API.
</Tip>