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

> How tightly does NVDA track SPY and its sector ETF?

Returns one-month and one-year correlation and beta to SPY and to the best sector ETF, with the IV-to-SPY ratio.

- **Family:** Stock analytics (https://apexvol.com/developers/stock-analytics-api)
- **Plan:** Premium and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** Correlations -1 to 1; beta unitless.
- **Basis:** Daily returns; best_etf is chosen by fit.
- **MCP tools:** `get_ticker_analytics`
- **Background:** https://apexvol.com/learn/options-portfolio-hedging

## 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/correlation/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": {
    "best_etf": "XLK",
    "beta": {
      "beta_1m": 3.08,
      "beta_1y": 1.93
    },
    "correlations": {
      "etf_1m": 0.52,
      "etf_1y": 0.27,
      "spy_1m": 0.49,
      "spy_1y": 0.41
    },
    "iv_spy_ratio": 2.7984,
    "price": 230.3,
    "sector": "Technology",
    "ticker": "NVDA"
  }
}
```

## Fields

- `correlations.spy_1m, spy_1y, etf_1m, etf_1y`: The correlations.
- `beta.beta_1m, beta_1y`: The betas.
- `best_etf, sector, iv_spy_ratio`: Context.

## Errors

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

## Ask it in an MCP client

- What is NVDA's beta and correlation to SPY?
- Which ETF tracks AMD best?
- Has AAPL's correlation to the market dropped this month?

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