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

> How much delta will dealers shed on SPY overnight from charm?

Returns total, call and put charm exposure for the chosen expiration and the per-strike breakdown, plus the detailed rows with IV and open interest.

- **Family:** Options Greeks (https://apexvol.com/developers/options-greeks-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:** charm_exposure is delta shares per day (positive means dealers gain long delta as time passes).
- **Basis:** Dealer convention: dealers short customer positions. Computed from open interest and per-contract charm.
- **MCP tools:** `get_charm_exposure`
- **Background:** https://apexvol.com/learn/what-is-delta

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |
| `expiration` | query | nearest | YYYY-MM-DD, a listed expiration | Which expiration to use. Defaults to the nearest one. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/charm/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": {
    "call_charm": 10023682.817,
    "charm_by_strike": [
      {
        "charm_exposure": 18249098.4446,
        "oi": 2372,
        "strike": 769
      },
      {
        "charm_exposure": 16525084.9209,
        "oi": 9544,
        "strike": 770
      },
      {
        "charm_exposure": -28726617.7301,
        "oi": 4457,
        "strike": 771
      }
    ],
    "data_status": "LIVE",
    "detailed": [
      {
        "charm": 17.7856,
        "charm_exposure": 10989702.8596,
        "iv": 0.0568,
        "oi": 6179,
        "strike": 770,
        "type": "C"
      },
      {
        "charm": 16.4499,
        "charm_exposure": 5535382.0614,
        "iv": 0.0615,
        "oi": 3365,
        "strike": 770,
        "type": "P"
      },
      {
        "charm": -67.7526,
        "charm_exposure": -9824127.9754,
        "iv": 0.0556,
        "oi": 1450,
        "strike": 771,
        "type": "C"
      }
    ],
    "dte": 0,
    "expiration": "2026-09-08",
    "put_charm": -4591755.8741,
    "stock_price": 770.25,
    "ticker": "SPY",
    "total_charm": 5431926.943
  }
}
```

## Fields

- `total_charm, call_charm, put_charm`: Aggregate charm exposure.
- `charm_by_strike[].strike, charm_exposure, oi`: The per-strike profile.
- `detailed[]`: Per contract with charm, IV and OI.
- `dte, expiration, stock_price`: Context.

## 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 delta decays out of SPY dealer books overnight?
- Which strikes carry the most charm on QQQ?
- Show charm exposure on NVDA for the nearest expiration.

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