# GET /api/mcp/data/iv-crush/{ticker}

> How much IV will NVDA lose after it reports, and what move does the current premium imply?

Returns the current and ATM IV, the estimated IV after the event and the crush in percent, the expected move and the historical average, and whether the nearest expiration is an earnings play.

- **Family:** Earnings and expected move (https://apexvol.com/developers/earnings-expected-move-api)
- **Plan:** Pro and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** IVs in percentage points; crush and moves in percent; straddle_price in dollars.
- **Basis:** Crush estimate comes from past reports; expected move from the straddle covering the report.
- **MCP tools:** `get_earnings_move_analysis`
- **Background:** https://apexvol.com/learn/iv-crush

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |
| `days_before` | query | 30 | 1 to 120 | Window before the report. |
| `days_after` | query | 30 | 1 to 120 | Window after the report. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/iv-crush/NVDA"
```

## Response (captured 2026-09-08)

Real response, lists cut to the rows nearest the money. The envelope is `{"success": true, "data": ...}`.

```json
{
  "success": true,
  "data": {
    "atm_iv": 38.3995,
    "current_iv": 34.43,
    "current_rv_annual": 43.4299,
    "days_to_earnings": 71,
    "days_to_expiration": 73,
    "earnings_date": "2026-11-18",
    "estimated_iv_after_event": 38.3995,
    "estimated_iv_crush_pct": 0.0,
    "expected_move": 27.54,
    "expected_move_pct": 11.9583,
    "historical_avg_move_pct": 2.1316,
    "is_earnings_play": false,
    "iv_premium": -8.9999,
    "iv_rank": 14.79,
    "iv_units": "percentage_points",
    "nearest_expiration": "2026-11-20",
    "stock_price": 230.3,
    "straddle_price": 32.4,
    "success": true,
    "ticker": "NVDA",
    "timestamp": "2026-09-08T08:07:33.972081"
  }
}
```

## Fields

- `estimated_iv_after_event, estimated_iv_crush_pct`: The crush.
- `expected_move_pct, historical_avg_move_pct`: Priced versus typical.
- `atm_iv, current_iv, iv_premium`: The IV build.
- `earnings_date, days_to_earnings, is_earnings_play`: Timing.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- `403`: Pro plan required
- `424`: data feed unavailable, retry
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- How much IV crush should I expect on NVDA after earnings?
- Is AAPL IV elevated going into its report?
- What move is priced for TSLA earnings versus its history?

Conventions for units, bases and timestamps: https://apexvol.com/developers/conventions