{"openapi":"3.1.0","info":{"title":"Crypto Correlation & Beta API","version":"1.0.0","description":"How crypto assets move together, computed live from Binance daily candles — no key, nothing stored. Correlation is the single most important input to diversification, pairs trading and risk: two coins with a correlation near 1 are effectively the same bet, while a low or negative correlation is genuine diversification. The matrix endpoint returns the full pairwise return-correlation matrix across a basket of coins over a chosen window, together with the average pairwise correlation — a one-number gauge of how \"risk-on, all-together\" the market is. The pair endpoint returns the correlation between any two coins, with the R-squared and a plain-language relationship label. The beta endpoint returns each coin's beta to BTC — how much it amplifies (beta above 1) or dampens (beta below 1) Bitcoin's moves — with its correlation and R-squared, the read altcoin traders use to size directional bets. Everything is computed from the standard deviation and covariance of daily log returns. This is the cross-asset correlation / beta analytics cut for crypto — distinct from the FX-correlation API, the single-asset realised-volatility API and the portfolio-optimiser in the catalogue. Coins are Binance bases (BTC, ETH) or full symbols (BTCUSDT); the quote defaults to USDT and the window is 14-365 days.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cryptocorrelation-api","description":"oanor gateway"}],"tags":[{"name":"Correlation"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/beta":{"get":{"operationId":"get_v1_beta","tags":["Correlation"],"summary":"Each coin's beta to BTC","description":"","parameters":[{"name":"coins","in":"query","required":false,"description":"Comma list of coins (default top majors)","schema":{"type":"string"},"example":"ETH,SOL,DOGE"},{"name":"window","in":"query","required":false,"description":"Lookback in days (14-365, default 90)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"beta = cov(coin, BTC) / var(BTC) on daily log returns: beta > 1 amplifies BTC moves, < 1 dampens, < 0 moves against. r_squared is how much of the coin's variance BTC explains.","betas":[{"beta":1.28,"coin":"ETH","r_squared":0.821,"correlation":0.906},{"beta":1.245,"coin":"SOL","r_squared":0.772,"correlation":0.878},{"beta":0.985,"coin":"DOGE","r_squared":0.605,"correlation":0.778}],"count":3,"source":"Binance","benchmark":"BTC","window_days":90,"observations":90},"meta":{"timestamp":"2026-06-12T01:41:09.338Z","request_id":"9093d429-7a47-4758-82b4-d413f2f27d37"},"status":"ok","message":"Beta retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/matrix":{"get":{"operationId":"get_v1_matrix","tags":["Correlation"],"summary":"Pairwise correlation matrix across a basket","description":"","parameters":[{"name":"coins","in":"query","required":false,"description":"Comma list of coins (default top majors)","schema":{"type":"string"},"example":"BTC,ETH,SOL,DOGE"},{"name":"window","in":"query","required":false,"description":"Lookback in days (14-365, default 90)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Pearson correlation of daily log returns over window_days; matrix[i][j] pairs coins[i] with coins[j]. average_pairwise_correlation near 1 means the market is moving as one (risk-on/off); low means real dispersion.","coins":["BTC","ETH","SOL","DOGE"],"matrix":[[1,0.906,0.878,0.778],[0.906,1,0.868,0.804],[0.878,0.868,1,0.812],[0.778,0.804,0.812,1]],"source":"Binance","window_days":90,"observations":90,"average_pairwise_correlation":0.841},"meta":{"timestamp":"2026-06-12T01:41:09.676Z","request_id":"74963a6f-2542-4d24-84dc-a1f7301716ba"},"status":"ok","message":"Matrix retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pair":{"get":{"operationId":"get_v1_pair","tags":["Correlation"],"summary":"Correlation between two coins","description":"","parameters":[{"name":"a","in":"query","required":true,"description":"First coin","schema":{"type":"string"},"example":"BTC"},{"name":"b","in":"query","required":true,"description":"Second coin","schema":{"type":"string"},"example":"ETH"},{"name":"window","in":"query","required":false,"description":"Lookback in days (14-365, default 90)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"a":"BTC","b":"ETH","source":"Binance","r_squared":0.8213,"correlation":0.9063,"window_days":90,"observations":90,"relationship":"very high (nearly the same bet)"},"meta":{"timestamp":"2026-06-12T01:41:10.013Z","request_id":"2aef6593-4548-4257-97f4-5db59d6f252d"},"status":"ok","message":"Pair retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"coins are Binance bases (BTC, ETH) or symbols (BTCUSDT); quote defaults to USDT. matrix/beta take coins=BTC,ETH,SOL (default top majors, max 15). window is 14-365 days (default 90). pair takes a= and b=.","source":"Binance public REST (api.binance.com/api/v3/klines, daily, live)","service":"cryptocorrelation-api","endpoints":{"GET /v1/beta":"Each coin's beta to BTC with correlation and R-squared (coins=ETH,SOL,DOGE, window=90).","GET /v1/meta":"This document.","GET /v1/pair":"Correlation between two coins (a=BTC, b=ETH, window=90).","GET /v1/matrix":"Pairwise correlation matrix across a basket + average pairwise correlation (coins=BTC,ETH,SOL, window=90)."},"description":"Crypto cross-asset correlation and beta, computed live from Binance daily candles (no key, nothing stored). matrix returns the full pairwise return-correlation matrix across a basket plus the average pairwise correlation. pair returns the correlation between two coins. beta returns each coin's beta to BTC with correlation and R-squared. From the covariance of daily log returns. The correlation/beta analytics cut for crypto — distinct from the FX-correlation API, the single-asset realised-volatility API and the portfolio-optimiser.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:41:10.350Z","request_id":"8e402e31-6782-4f6c-9bf2-c1d9b149d824"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":450,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1088,"monthly_call_quota":12500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3488,"monthly_call_quota":70000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7920,"monthly_call_quota":360000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cryptocorrelation-api"}