# GET /api/mcp/data/mispricing-assessment/{ticker}

> Taking IV rank, VRP and the priced move together, are NVDA options rich or cheap?

Combines IV rank, the volatility risk premium and expected-versus-actual into a signal from -100 to +100 with confidence, and returns every component and the historical move distribution it used.

- **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:** Score -100 to +100; confidence 0 to 100; IVs in percentage points; moves in percent.
- **Basis:** components.current_iv is on the VRP basis (30-day constant maturity); iv_basis, hv_basis and earnings_in_window are returned.
- **MCP tools:** `get_earnings_move_analysis`
- **Background:** https://apexvol.com/learn/volatility-risk-premium

## 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/mispricing-assessment/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": {
    "components": {
      "current_iv": 33.05,
      "earnings_in_window": true,
      "expected_move_pct": 4.55,
      "historical_avg_move_pct": 4.46,
      "hv_basis": "close_to_close_log_returns_annualized_252",
      "iv_basis": "iv30d_constant_maturity_eod",
      "iv_percentile": 12.0,
      "iv_rank": 14.8,
      "options_assessment": "FAIRLY_PRICED",
      "realized_vol": 45.06,
      "vrp": -12.01
    },
    "confidence": 100.0,
    "historical_moves": {
      "14d": {
        "avg_abs_move_pct": 5.4003,
        "avg_move_pct": 1.7376,
        "max_down_move_pct": -10.5131,
        "max_up_move_pct": 14.8871,
        "median_move_pct": 1.5093,
        "p10": -6.4665,
        "p25": -3.1976,
        "p75": 6.1163,
        "p90": 9.9673,
        "period_days": 14,
        "std_dev_pct": 6.3057
      },
      "21d": {
        "avg_abs_move_pct": 6.7007,
        "avg_move_pct": 2.7348,
        "max_down_move_pct": -12.588,
        "max_up_move_pct": 19.0191,
        "median_move_pct": 3.3738,
        "p10": -8.3477,
        "p25": -1.921,
        "p75": 8.5737,
        "p90": 11.7969,
        "period_days": 21,
        "std_dev_pct": 7.5251
      },
      "30d": {
        "avg_abs_move_pct": 7.1714,
        "avg_move_pct": 2.1683,
        "max_down_move_pct": -17.841,
        "max_up_move_pct": 15.395,
        "median_move_pct": 2.5263,
        "p10": -10.2469,
        "p25": -4.2495,
        "p75": 8.7686,
        "p90": 11.9596,
        "period_days": 30,
        "std_dev_pct": 8.2063
      },
      "7d": {
        "avg_abs_move_pct": 4.7327,
        "avg_move_pct": 1.1532,
        "max_down_move_pct": -10.7926,
        "max_up_move_pct": 18.5403,
        "median_move_pct": 0.5243,
        "p10": -5.6893,
        "p25": -2.9056,
        "p75": 5.0021,
        "p90": 8.8667,
        "period_days": 7,
        "std_dev_pct": 5.9155
      }
    },
    "mispricing_score": -55.2,
    "signal": "BUY_PREMIUM",
    "ticker": "NVDA",
    "timestamp": "2026-09-08T08:07:35.431474+00:00"
  }
}
```

## Fields

- `signal, mispricing_score, confidence`: The answer.
- `components.iv_rank, iv_percentile, vrp, expected_move_pct, historical_avg_move_pct`: What drove it.
- `components.earnings_in_window`: Whether a report contaminates realized vol.
- `historical_moves`: The move distribution used.

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

- Are NVDA options rich or cheap overall right now?
- Give me a premium buy-or-sell signal for AAPL with the components.
- Which of my watchlist screens as sell-premium?

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