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

> How correlated are NVDA and AMD, and has it changed?

Returns a daily series of one-month and one-year correlation and one-month beta between the two tickers.

- **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 over days of history.
- **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. |
| `ticker2` (required) | path |  | symbol | The second ticker. |
| `days` | query | 400 | 20 to 1000 | History length. |

## Request

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

## 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": {
    "ticker1": "NVDA",
    "ticker2": "AMD",
    "timeseries": [
      {
        "beta1m": null,
        "correl1m": null,
        "correl1y": null,
        "date": "2025-08-05"
      },
      {
        "beta1m": null,
        "correl1m": null,
        "correl1y": null,
        "date": "2025-08-06"
      },
      {
        "beta1m": null,
        "correl1m": null,
        "correl1y": null,
        "date": "2025-08-07"
      }
    ]
  }
}
```

## Fields

- `timeseries[].date, correl1m, correl1y, beta1m`: The pair through time.
- `ticker1, ticker2`: Echo.

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

- How correlated are NVDA and AMD?
- Show the correlation between XOM and CVX over the last year.
- Has the SPY-QQQ correlation broken down recently?

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