# GET /api/mcp/data/

> Which endpoints does the ApexVol API expose, and what does each one need?

Returns the whole token surface as one JSON list. For each endpoint you get the HTTP method, the full path with its placeholders, the family it belongs to, the plan it needs, a one-line description, the query parameters with their defaults, the developer page that documents it and a request line that works as written. The family list, the endpoint count and links to the OpenAPI spec and the Markdown reference come with it. The list is read from the same records that build the developer pages, so it can never lag them. A client that holds a token can discover the API from this one call instead of a bookmarked docs page, and an unknown path answers with did_you_mean entries in this same shape.

- **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:** No market data is involved. The response is the catalogue itself, and the call costs nothing against the monthly allowance.
- **Basis:** Generated from the endpoint records at request time. The version and updated fields say which weekly capture the example requests come from.
- **Background:** https://apexvol.com/learn/options-data-api

## Parameters

No parameters.

## Request

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

## 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": {
    "endpoint_count": 60,
    "version": 1,
    "updated": "2026-09-08",
    "docs": "https://apexvol.com/docs/api",
    "openapi": "https://apexvol.com/docs/api/openapi.json",
    "markdown": "https://apexvol.com/llms-full.txt",
    "families": [
      {
        "slug": "implied-volatility-api",
        "name": "Implied volatility",
        "endpoint_count": 11,
        "docs": "https://apexvol.com/developers/implied-volatility-api"
      },
      {
        "slug": "options-chain-api",
        "name": "Options chain",
        "endpoint_count": 7,
        "docs": "https://apexvol.com/developers/options-chain-api"
      },
      {
        "slug": "options-greeks-api",
        "name": "Options Greeks",
        "endpoint_count": 3,
        "docs": "https://apexvol.com/developers/options-greeks-api"
      }
    ],
    "endpoints": [
      {
        "method": "GET",
        "path": "/api/mcp/data/hv-regimes/{ticker}",
        "family": "implied-volatility-api",
        "one_liner": "Historical volatility across windows, its term structure and the regime crossovers.",
        "tier": "premium",
        "params": "view=dashboard, days=252",
        "docs": "https://apexvol.com/developers/implied-volatility-api/hv-regimes",
        "example": "GET /api/mcp/data/hv-regimes/NVDA"
      },
      {
        "method": "GET",
        "path": "/api/mcp/data/iv-opportunities/{ticker}",
        "family": "implied-volatility-api",
        "one_liner": "IV mean-reversion read: z-score, reversion target and the expected IV change.",
        "tier": "premium",
        "params": "",
        "docs": "https://apexvol.com/developers/implied-volatility-api/iv-opportunities",
        "example": "GET /api/mcp/data/iv-opportunities/NVDA"
      },
      {
        "method": "GET",
        "path": "/api/mcp/data/iv-rank/{ticker}",
        "family": "implied-volatility-api",
        "one_liner": "IV rank and IV percentile against the last year, with the range they were measured on.",
        "tier": "premium",
        "params": "lookback_days=252",
        "docs": "https://apexvol.com/developers/implied-volatility-api/iv-rank",
        "example": "GET /api/mcp/data/iv-rank/NVDA"
      }
    ]
  }
}
```

## Fields

- `endpoint_count`: How many endpoints the list holds.
- `endpoints[].method, path`: The HTTP method and the full path. {ticker} marks a path parameter.
- `endpoints[].tier`: The lowest plan whose tokens can call it: basic, premium or pro.
- `endpoints[].params`: The query parameters with their defaults, on one line.
- `endpoints[].docs`: The developer page for the endpoint.
- `endpoints[].example`: A request line that works as written, the one the docs sample was captured from.
- `families[]`: The endpoint families with their page and endpoint count.
- `openapi, markdown`: The OpenAPI 3.1 spec and the single-file Markdown reference.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- List every ApexVol API endpoint and the plan each one needs.
- Which endpoints cover earnings, and what parameters do they take?
- Give me a working example request for each gamma exposure endpoint.

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