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
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
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.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.Response
Available TradFi assets
The following TradFi asset IDs are supported in theids 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.
