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

> Is NVDA's IV stretched far enough from its mean to expect reversion?

Compares current IV with its mean and standard deviation, returns the z-score, a reversion target and the expected IV move, and labels whether an extreme is present.

- **Family:** Implied volatility (https://apexvol.com/developers/implied-volatility-api)
- **Plan:** Premium and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** IVs are annualised percentage points; z_score is in standard deviations; expected_pct_change is percent.
- **Basis:** Mean and standard deviation are taken over the IV series behind /iv-rank.
- **MCP tools:** `find_iv_opportunities`
- **Background:** https://apexvol.com/learn/volatility-trading

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/iv-opportunities/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": {
    "current_iv": 34.43,
    "expected_iv_move": 0,
    "expected_pct_change": 0.0,
    "iv_percentile": 12.0,
    "iv_rank": 14.79,
    "iv_units": "percentage_points",
    "mean_iv": 38.53,
    "opportunity": "NO_EXTREME",
    "reversion_target": 34.43,
    "std_iv": 3.31,
    "term_structure": [
      {
        "expiration": "2026-09-09",
        "iv": 25.87,
        "z_score": -3.8248
      },
      {
        "expiration": "2026-09-11",
        "iv": 30.44,
        "z_score": -2.4441
      },
      {
        "expiration": "2026-09-14",
        "iv": 28.78,
        "z_score": -2.9456
      }
    ],
    "ticker": "NVDA",
    "timestamp": "2026-09-08T08:06:45.029743",
    "z_score": -1.2387
  }
}
```

## Fields

- `current_iv, mean_iv, std_iv`: Today's IV and its distribution.
- `z_score`: How far IV is from its mean, in standard deviations.
- `reversion_target, expected_iv_move`: Where IV would go if it reverted.
- `opportunity`: SELL_VOL, BUY_VOL or NO_EXTREME.
- `term_structure[].z_score`: The same read per expiration.

## Errors

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

## Ask it in an MCP client

- Is NVDA's implied vol stretched relative to its mean?
- Which of my watchlist has an IV z-score above 2?
- Should I expect AAPL IV to revert from here?

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