# GET /api/mcp/data/options-by-delta/{ticker}

> Which NVDA call is closest to 30 delta, and what does it cost?

Returns the single call or put whose delta is closest to the target for the chosen expiration, with the actual delta, strike, bid, ask, mid and IV.

- **Family:** Options chain (https://apexvol.com/developers/options-chain-api)
- **Plan:** Basic and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** iv is a decimal (0.2569); iv_pct carries the same value in percentage points. Prices are dollars.
- **Basis:** Delta from the chain row. delta is bounded to 0.01 to 0.99.
- **MCP tools:** `get_options_by_delta`
- **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. |
| `delta` | query | 0.3 | 0.01 to 0.99 | Target absolute delta. |
| `option_type` | query | call | call or put | Which side. |
| `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/options-by-delta/NVDA?delta=0.30&option_type=call"
```

## 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": {
    "actual_delta": 0.2609,
    "ask": 1.08,
    "bid": 1.05,
    "expiration": "2026-09-09",
    "iv": 0.2569,
    "iv_pct": 25.69,
    "iv_units": "decimal",
    "mid": 1.065,
    "option_type": "call",
    "stock_price": 230.3,
    "strike": 235.0,
    "target_delta": 0.3,
    "ticker": "NVDA"
  }
}
```

## Fields

- `strike, actual_delta, target_delta`: The contract chosen and how close it is.
- `bid, ask, mid`: The quote.
- `iv, iv_pct, iv_units`: Implied vol in both forms.
- `expiration, stock_price`: Context for the pick.

## Errors

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

## Ask it in an MCP client

- Which NVDA call is closest to 30 delta for the nearest expiration?
- Find the 20-delta put on SPY for October.
- What is the mid on the 16-delta AAPL call?

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