Skip to main content
Compute pairwise Pearson correlation coefficients for any combination of crypto assets and traditional finance instruments. The resulting NxN matrix is built from daily log returns and supports lookback periods from 30 days to 3 years. Use it for portfolio diversification analysis, regime detection, or cross-asset risk monitoring.

Get correlation matrix

GET /v1/correlation/matrix Returns a symmetric correlation matrix for the requested assets and period. The matrix is computed from daily log returns with a minimum data coverage threshold of 80%. Asset pairs with insufficient overlapping data return null coefficients.

Query parameters

string
Lookback period. One of 30d, 90d, 1y, 3y. Defaults to 30d.
string
Comma-separated asset identifiers. Crypto assets use canonical IDs (e.g., bitcoin, ethereum, solana). TradFi assets use short IDs (e.g., sp500, gold, dxy, aapl, nvda). Maximum 10 assets. Defaults to bitcoin,ethereum,solana,sp500,gold. Ids no source recognises get a row and column with null correlations and are listed in an optional unresolved array (partial success); a selection none of whose ids is recognised returns 404 resource_not_found naming them.

Response fields

array
Ordered array of asset metadata matching the matrix dimensions.
string
Asset identifier (canonical crypto ID or TradFi short ID).
string
Display name (e.g., Bitcoin, S&P 500).
string
Ticker symbol (e.g., BTC, SPY).
string
"crypto" or "tradfi".
string
URL to the asset logo, if available.
(number | null)[][]
NxN array of Pearson correlation coefficients. matrix[i][j] is the correlation between assets[i] and assets[j]. Values are in [-1, 1], or null when fewer than 80% of the period’s days are present in both series. Self-correlations on the diagonal are 1, or null when the asset has no observations in the period.
number[][]
NxN array of integers. dataPoints[i][j] is the number of overlapping daily observations used to compute matrix[i][j]. TradFi-only pairs use trading-day counts (≈252/year), so a 90-day period yields fewer points than a crypto-only pair over the same window.
string
The period that was applied.
string
ISO 8601 timestamp of the last matrix computation, or null.
Response

Available TradFi assets

The following TradFi asset IDs are supported in the ids parameter. Crypto assets use their canonical ID (e.g., bitcoin, ethereum, solana, dogecoin).

Indices and commodities

US stocks

Additional stocks are available on demand: amd, nflx, crm, dis, ba, ko, pep, wmt, cost, intc, pypl, coin, mstr, pltr, uber, sq, snow, sofi, hood, spot. GET /v1/correlation/matrix?ids=bitcoin,nvda,sp500
Response

Interpreting correlation values

TradFi assets (stocks, indices) only have data on trading days, so dataPoints will be lower than crypto pairs for the same period. A 90-day period yields ~64 TradFi data points versus 90 for crypto-only pairs.
Read the error reference