# GET /api/mcp/data/skew/{ticker}

> How steep is NVDA's put skew today compared with its own history and its sector?

Returns the current skew slope and its forecast, the smile curvature with an interpretation, where today's slope sits against its one-month and one-year averages, and the ratio to the sector ETF. Other views return the history or the curvature only.

- **Family:** Implied volatility (https://apexvol.com/developers/implied-volatility-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:** slope and curvature are the data feed's surface parameters (unitless); percentile.current is 0 to 100; market_width.vol is in percentage points.
- **Basis:** Slope is measured on the smoothed vol surface at the 30-day tenor. Read it against percentile.avg_1y rather than as an absolute.
- **MCP tools:** `get_ticker_analytics`
- **Background:** https://apexvol.com/learn/volatility-skew

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |
| `view` | query | analysis | analysis, history, curvature | Which block to return. |
| `days` | query | 252 | 20 to 1000 | History length for view=history. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/skew/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": {
      "slope": 1.2147,
      "slope_forecast": 1.0845,
      "slope_forecast_inf": 1.0637,
      "slope_inf": 0.9391
    },
    "curvature": {
      "deriv": 0.0594,
      "deriv_forecast": 0.0391,
      "deriv_forecast_inf": 0.0532,
      "deriv_inf": 0.058,
      "interpretation": "smile",
      "mispricing": 0.0203
    },
    "market_width": {
      "vol": 0.58,
      "vol_inf": 0.63
    },
    "percentile": {
      "avg_1m": 0.9104,
      "avg_1y": 2.1043,
      "current": 25.79,
      "stdv_1y": 1.29
    },
    "price": 230.3,
    "sector": "Technology",
    "sector_relative": {
      "etf_slope_ratio": 0.4
    },
    "ticker": "NVDA"
  }
}
```

## Fields

- `current.slope, slope_forecast`: Today's skew slope and the model forecast.
- `percentile.current, avg_1m, avg_1y, stdv_1y`: Today's slope percentile and the averages it is compared with.
- `curvature.interpretation, mispricing`: What the smile shape says.
- `sector_relative.etf_slope_ratio`: Skew relative to the sector ETF.

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

- Is NVDA's put skew steep right now compared with the last year?
- How does AAPL's skew compare with its sector ETF?
- Show me the skew history for SPY over 6 months.

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