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

# Analyze Missed Rewards

> Identify and quantify rewards lost due to missed or delayed validator duties

## Overview

Missed rewards represent potential earnings your validators could have received if they had performed perfectly. Tracking missed rewards helps you identify issues, optimize performance, and quantify the cost of downtime or misconfigurations.

<Note>
  **API Endpoint:** This guide uses [`/api/v2/ethereum/validators/rewards-list`](/api-reference/ethereum/validators/rewards-list) for per-epoch missed reward breakdowns.
</Note>

<Tip>
  **See Also:** The [APY & ROI Metrics](/use-cases/apy-roi) endpoint also provides missed reward data as part of its return calculations. Use this document for detailed per-epoch analysis; use APY & ROI for aggregated impact on your returns.
</Tip>

***

## Why Track Missed Rewards?

<CardGroup cols={2}>
  <Card title="Diagnose Issues" icon="stethoscope">
    Identify which duty types (attestations, proposals, sync) are causing losses.
  </Card>

  <Card title="Quantify Downtime Cost" icon="calculator">
    Calculate the exact ETH lost during outages or maintenance windows.
  </Card>

  <Card title="Optimize Setup" icon="sliders">
    Compare missed rewards before/after configuration changes to measure improvements.
  </Card>

  <Card title="Client Reporting" icon="file-invoice">
    Show customers transparent breakdowns of actual vs. potential earnings.
  </Card>

  <Card title="Impact on Returns" icon="percent" href="/use-cases/apy-roi">
    See how missed rewards affect your overall APY & ROI using aggregated metrics.
  </Card>
</CardGroup>

***

## Understanding Missed Rewards

This workflow focuses on diagnosing which duties contributed to lost earnings over time. See the [Rewards List API reference](/api-reference/ethereum/validators/rewards-list).

<Note>
  **Missed vs Penalty:** Missed rewards are potential earnings you didn't receive. Penalties are actual deductions from your balance. Both reduce your net rewards, but penalties are more severe.
</Note>

***

## Quick Start: Fetch Missed Rewards

Get missed rewards for a specific epoch:

```bash theme={null}
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/rewards-list \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "mainnet",
  "validator": {
    "dashboard_id": 123
  },
  "epoch": 414000,
  "page_size": 10
}
'
```

### Response

```json theme={null}
{
  "data": [
    {
      "validator": {
        "index": 123456,
        "public_key": "0xabc..."
      },
      "total": "9103000000000",
      "total_reward": "9103000000000",
      "total_penalty": "0",
      "total_missed": "250000000000",
      "attestation": {
        "total": "9103000000000",
        "head": {
          "total": "2348000000000",
          "reward": "2348000000000",
          "penalty": "0",
          "missed_reward": "0"
        },
        "source": {
          "total": "2364000000000",
          "reward": "2364000000000",
          "penalty": "0",
          "missed_reward": "0"
        },
        "target": {
          "total": "4391000000000",
          "reward": "4391000000000",
          "penalty": "0",
          "missed_reward": "0"
        }
      },
      "sync_committee": {
        "total": "0",
        "reward": "0",
        "penalty": "0",
        "missed_reward": "0"
      },
      "proposal": {
        "total": "0",
        "missed_cl_reward": "0",
        "missed_el_reward": "0"
      }
    }
  ]
}
```

## Common Causes of Missed Rewards

| Cause                      | Affected Duties | Solution                                                  |
| -------------------------- | --------------- | --------------------------------------------------------- |
| **Network latency**        | Head votes      | Reduce latency to beacon node, use local execution client |
| **Node downtime**          | All duties      | Implement redundancy, monitoring, and failover            |
| **Missed proposals**       | Proposals       | Ensure MEV-boost and execution client are responsive      |
| **Sync committee offline** | Sync committee  | Keep validators online during sync committee periods      |
| **Clock drift**            | Attestations    | Use NTP synchronization                                   |

<Tip>
  Use the [Notifications](/notifications-monitoring/notifications) system to get alerts when validators miss duties. Early detection minimizes losses.
</Tip>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Monitor Regularly" icon="chart-line">
    Track missed rewards weekly to catch degradation before it becomes significant.
  </Card>

  <Card title="Set Thresholds" icon="bell">
    Alert when missed rewards exceed a percentage of total rewards (e.g., >0.1%).
  </Card>

  <Card title="Compare to BeaconScore" icon="scale-balanced">
    Use BeaconScore for relative comparison; use missed rewards for absolute ETH impact.
  </Card>

  <Card title="Investigate Spikes" icon="magnifying-glass">
    When missed rewards spike, check node logs, network status, and duty assignments.
  </Card>
</CardGroup>

***

## See Missed Rewards Impact on APY & ROI

For a high-level view of how missed rewards affect your overall returns, use the [APY & ROI API](/use-cases/apy-roi). This endpoint provides aggregated missed reward data as part of its return calculations:

```bash theme={null}
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/apy-roi \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain": "mainnet",
    "validator": { "dashboard_id": 123 },
    "evaluation_window": "30d"
  }'
```

The following example uses the [APY & ROI API](/api-reference/ethereum/validators/apy-roi):

```json theme={null}
{
  "data": {
    "execution_layer": {
      "roi": { "total": 0.0012, "missed": -0.0001 },
      "apy": { "total": 0.0146, "missed": -0.0012 }
    },
    "consensus_layer": {
      "roi": { "total": 0.0008, "missed": -0.00005 },
      "apy": { "total": 0.0097, "missed": -0.0006 }
    }
  }
}
```

<Tip>
  **When to use which endpoint:**

  * Use **`rewards-list`** (this document) for detailed per-epoch missed reward breakdowns by duty type
  * Use **`apy-roi`** for aggregated impact on your overall returns as a percentage
</Tip>

***

## Related Resources

* [Monitor Validator Performance](/use-cases/performance-introduction) — BeaconScore and efficiency metrics
* [APY & ROI Metrics](/use-cases/apy-roi) — Calculate return on investment
* [Custom Range Rewards](/use-cases/rewards-custom-range) — Calculate rewards for any date range
* [Notifications](/notifications-monitoring/notifications) — Set up alerts for missed duties