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

> What does the smoothed vol surface say about SPY at each delta and expiration?

Returns the ATM IV, slope, curvature and the smile across delta points for each expiration, either as the market's smoothed surface, the vendor forecast, or a rich-versus-cheap comparison of the two.

- **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:** atm_iv and the smile values are annualised percentage points; slope and curvature are surface parameters.
- **Basis:** Surface points are the data feed's smoothed fit, not raw quotes. Expirations may include the most recent expired date; filter on dte greater than 0.
- **MCP tools:** `get_monies_surface`
- **Background:** https://apexvol.com/learn/volatility-surface

## Parameters

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

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/monies/SPY"
```

## 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": {
    "delta_points": [
      0,
      5,
      10
    ],
    "expirations": [
      {
        "atm_iv": 6.62,
        "confidence": 0.304,
        "curvature": 0,
        "dte": -4,
        "earn_effect": 0,
        "expiration": "2026-09-04",
        "slope": 0,
        "smile": {
          "0": 7.03,
          "5": 7.17,
          "10": 7.31,
          "15": 7.45,
          "20": 7.59,
          "25": 7.73,
          "30": 7.87,
          "35": 8.02,
          "40": 8.16,
          "45": 8.3,
          "50": 8.44,
          "55": 8.58,
          "60": 8.72,
          "65": 8.87,
          "70": 9.01,
          "75": 9.15,
          "80": 9.29,
          "85": 9.43,
          "90": 9.57,
          "95": 9.71,
          "100": 9.86
        },
        "stock_price": 770.25
      },
      {
        "atm_iv": 5.8,
        "confidence": 1,
        "curvature": 0.1178,
        "dte": 0,
        "earn_effect": 0,
        "expiration": "2026-09-08",
        "slope": 4.7079,
        "smile": {
          "0": 6.01,
          "5": 5.54,
          "10": 5.49,
          "15": 5.48,
          "20": 5.5,
          "25": 5.53,
          "30": 5.57,
          "35": 5.63,
          "40": 5.7,
          "45": 5.79,
          "50": 5.89,
          "55": 6.01,
          "60": 6.16,
          "65": 6.33,
          "70": 6.53,
          "75": 6.78,
          "80": 7.09,
          "85": 7.48,
          "90": 8.0,
          "95": 8.79,
          "100": 11.47
        },
        "stock_price": 770.25
      },
      {
        "atm_iv": 6.92,
        "confidence": 1,
        "curvature": 0.1286,
        "dte": 1,
        "earn_effect": 0,
        "expiration": "2026-09-09",
        "slope": 4.5584,
        "smile": {
          "0": 6.65,
          "5": 6.52,
          "10": 6.54,
          "15": 6.55,
          "20": 6.56,
          "25": 6.58,
          "30": 6.6,
          "35": 6.64,
          "40": 6.7,
          "45": 6.79,
          "50": 6.9,
          "55": 7.04,
          "60": 7.23,
          "65": 7.47,
          "70": 7.77,
          "75": 8.15,
          "80": 8.64,
          "85": 9.27,
          "90": 10.16,
          "95": 11.56,
          "100": 16.73
        },
        "stock_price": 770.25
      }
    ],
    "stock_price": 770.25,
    "success": true,
    "ticker": "SPY",
    "timestamp": "2026-09-08T04:24:54.451794"
  }
}
```

## Fields

- `expirations[].expiration, dte, atm_iv`: The ATM point per expiration.
- `expirations[].slope, curvature, smile`: The smile parameters and the values at each delta point.
- `delta_points`: The deltas the smile is sampled at.
- `expirations[].earn_effect`: Earnings contribution to that expiration's IV.

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

- Show me the SPY vol surface by delta for the next 3 expirations.
- Where is the forecast surface cheaper than the market on NVDA?
- What is the 25-delta put IV versus ATM on AAPL for October?

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