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

> Which expirations are listed for NVDA?

Returns the expiration dates the platform has a chain for, nearest first. Use it before calling an expiration-specific endpoint.

- **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:** Dates as YYYY-MM-DD.
- **Basis:** Live listing from the data feed.
- **MCP tools:** `get_expirations`
- **Background:** https://apexvol.com/learn/options-expiration

## 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/expirations/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": {
    "expirations": [
      "2026-09-09",
      "2026-09-11",
      "2026-09-14"
    ]
  }
}
```

## Fields

- `expirations[]`: Expiration dates, nearest first.

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

- What expirations does NVDA have listed?
- Is there a weekly expiration for AAPL next Friday?
- List the next 6 SPY expirations.

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