# Cross-Asset Correlation Matrix API
> How the major asset classes move together — a live correlation matrix across stocks, bonds, gold, oil, crypto and the dollar (no key, nothing stored). Correlation is the single most important input to diversification and risk: two assets with a correlation near 1 are effectively the same bet, while a low or negative correlation is genuine diversification. Where a crypto-correlation API stays inside crypto and an FX-correlation API stays inside currencies, this spans the whole multi-asset book at once — US and international equities, Treasuries and credit, gold, silver, oil and broad commodities, Bitcoin and Ether, the dollar and real estate — so an allocator can see in one call whether bonds are still hedging stocks, whether gold is decoupled and whether crypto is trading as a risk asset. The matrix endpoint returns the full pairwise return-correlation matrix over a chosen window, with the most- and least-correlated pairs. The asset endpoint returns one asset's correlation to every other, ranked, so you see its best diversifiers at a glance. The assets endpoint lists what is covered. The cross-asset / multi-asset correlation surface — distinct from the crypto-only correlation API, the FX-only currency-correlation API and the bring-your-own-series CAPM, risk-metrics and portfolio-optimiser calculators.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/crossassetcorrelation-api/..."
```

## Pricing
- **Free** (Free) — 700 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 18,000 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 90,000 calls/Mo, 16 req/s
- **Business** ($79/Mo) — 480,000 calls/Mo, 40 req/s

## Endpoints

### Matrix

#### `GET /v1/matrix` — Full pairwise cross-asset correlation matrix with most/least correlated pairs

**Parameters:**
- `window` (query, optional, string) — Lookback in days (20-365) Example: `90`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crossassetcorrelation-api/v1/matrix?window=90"
```

### Asset

#### `GET /v1/asset` — One asset correlation to all others, ranked, with best diversifiers

**Parameters:**
- `asset` (query, required, string) — Asset key (see /v1/assets) Example: `gold`
- `window` (query, optional, string) — Lookback in days (20-365) Example: `90`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crossassetcorrelation-api/v1/asset?asset=gold&window=90"
```

### Assets

#### `GET /v1/assets` — Supported cross-asset instruments

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crossassetcorrelation-api/v1/assets"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crossassetcorrelation-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/crossassetcorrelation-api
OpenAPI spec: https://www.oanor.com/api/crossassetcorrelation-api/openapi.json