# 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" ``` **Response:** ```json { "data": { "to": "2026-06-11", "from": "2026-03-10", "note": "Full pairwise Pearson correlation of daily (log) returns across asset classes, aligned on common trading days. +1 = move together (same bet), 0 = unrelated, -1 = move opposite (a hedge). most_correlated pairs double up risk; least_correlated are the best diversifiers.", "assets": [ { "key": "us_equities", "class": "equities", "label": "US Equities (S&P 500)" }, { "key": "us_tech", "class": "equities", "label": "US Tech (Nasdaq 100)" }, { "key": "us_smallcap", "class": "equities", "label": "US Small Caps" }, { "key": "intl_developed", "class": "equities", "label": "Developed ex-US Equities" }, { "key": "emerging", "class": "equities", "label": "Emerging Market Equities" }, { "key": "long_treasuries", "class": "bonds", "label": "Long US Treasuries" }, { "key": "mid_treasuries", "class": "bonds", "label": "7-10y US Treasuries" }, { "key": "ig_credit", …(truncated, see openapi.json for full schema) ``` ### 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" ``` **Response:** ```json { "data": { "to": "2026-06-11", "from": "2026-03-10", "note": "One asset's Pearson correlation to every other, ranked high to low. best_diversifiers are the lowest / most negative — the assets that most reduce concentration risk when held alongside this one.", "asset": "gold", "class": "commodities", "label": "Gold", "source": "Yahoo Finance + Binance", "window_days": 90, "correlations": [ { "key": "silver", "class": "commodities", "label": "Silver", "correlation": 0.836 }, { "key": "intl_developed", "class": "equities", "label": "Developed ex-US Equities", "correlation": 0.686 }, { "key": "us_equities", "class": "equities", "label": "US Equities (S&P 500)", "correlation": 0.668 }, { "key": "us_tech", "class": "equities", "label": "US Tech (Nasdaq 100)", "correlation": 0.655 }, { "key": "emerging", "class": "equities", "label": "Emerging Market Equities", "correlation": 0.624 }, { "key": "us_smallcap", "class": "equities", …(truncated, see openapi.json for full schema) ``` ### Assets #### `GET /v1/assets` — Supported cross-asset instruments **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/crossassetcorrelation-api/v1/assets" ``` **Response:** ```json { "data": { "note": "Supported cross-asset instruments (liquid ETFs and Bitcoin/Ether). Pass key as asset= to /v1/asset.", "count": 17, "assets": [ { "key": "us_equities", "class": "equities", "label": "US Equities (S&P 500)" }, { "key": "us_tech", "class": "equities", "label": "US Tech (Nasdaq 100)" }, { "key": "us_smallcap", "class": "equities", "label": "US Small Caps" }, { "key": "intl_developed", "class": "equities", "label": "Developed ex-US Equities" }, { "key": "emerging", "class": "equities", "label": "Emerging Market Equities" }, { "key": "long_treasuries", "class": "bonds", "label": "Long US Treasuries" }, { "key": "mid_treasuries", "class": "bonds", "label": "7-10y US Treasuries" }, { "key": "ig_credit", "class": "bonds", "label": "Investment-Grade Credit" }, { "key": "high_yield", "class": "bonds", "label": "Hig …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/crossassetcorrelation-api/v1/meta" ``` **Response:** ```json { "data": { "note": "window is 20-365 days (default 90). Correlations use daily log returns aligned on common trading days (crypto trades 24/7; equities weekdays — the intersection is used). Read fresh per call, nothing cached.", "source": "Yahoo Finance ETFs + Binance (BTC/ETH) daily, live", "classes": [ "equities", "bonds", "commodities", "crypto", "currency", "real_estate" ], "service": "crossasset-correlation-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/asset": "One asset's correlation to all others, ranked, with best diversifiers (asset=gold, window=90).", "GET /v1/assets": "The supported cross-asset instruments.", "GET /v1/matrix": "Full pairwise cross-asset correlation matrix with most/least correlated pairs (window=90)." }, "description": "Cross-asset correlation matrix — how stocks, bonds, gold, oil, crypto and the dollar move together, computed live (no key, nothing stored). matrix returns the full pairwise return-correlation matrix across the multi-asset book with the most- and least-correlated pairs. asset returns one asset's correlation to every other, ranked, with its best diversifiers. assets 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 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/crossassetcorrelation-api OpenAPI spec: https://www.oanor.com/api/crossassetcorrelation-api/openapi.json