{"openapi":"3.1.0","info":{"title":"Cross-Asset Correlation Matrix API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/crossassetcorrelation-api","description":"oanor gateway"}],"tags":[{"name":"Matrix"},{"name":"Asset"},{"name":"Assets"},{"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/matrix":{"get":{"operationId":"get_v1_matrix","tags":["Matrix"],"summary":"Full pairwise cross-asset correlation matrix with most/least correlated pairs","description":"","parameters":[{"name":"window","in":"query","required":false,"description":"Lookback in days (20-365)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","class":"bonds","label":"Investment-Grade Credit"},{"key":"high_yield","class":"bonds","label":"High-Yield Credit"},{"key":"gold","class":"commodities","label":"Gold"},{"key":"silver","class":"commodities","label":"Silver"},{"key":"oil","class":"commodities","label":"Crude Oil"},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities"},{"key":"bitcoin","class":"crypto","label":"Bitcoin"},{"key":"ether","class":"crypto","label":"Ether"},{"key":"us_dollar","class":"currency","label":"US Dollar"},{"key":"real_estate","class":"real_estate","label":"US Real Estate (REITs)"}],"matrix":{"oil":{"oil":1,"gold":-0.336,"ether":-0.15,"silver":-0.402,"bitcoin":-0.216,"us_tech":-0.474,"emerging":-0.581,"ig_credit":-0.542,"us_dollar":0.628,"high_yield":-0.568,"real_estate":-0.45,"us_equities":-0.569,"us_smallcap":-0.599,"intl_developed":-0.674,"mid_treasuries":-0.521,"long_treasuries":-0.499,"broad_commodities":0.92},"gold":{"oil":-0.336,"gold":1,"ether":0.343,"silver":0.836,"bitcoin":0.336,"us_tech":0.655,"emerging":0.624,"ig_credit":0.5,"us_dollar":-0.45,"high_yield":0.546,"real_estate":0.313,"us_equities":0.668,"us_smallcap":0.597,"intl_developed":0.686,"mid_treasuries":0.588,"long_treasuries":0.404,"broad_commodities":-0.187},"ether":{"oil":-0.15,"gold":0.343,"ether":1,"silver":0.352,"bitcoin":0.899,"us_tech":0.517,"emerging":0.489,"ig_credit":0.285,"us_dollar":-0.291,"high_yield":0.289,"real_estate":-0.055,"us_equities":0.465,"us_smallcap":0.395,"intl_developed":0.375,"mid_treasuries":0.302,"long_treasuries":0.174,"broad_commodities":-0.072},"silver":{"oil":-0.402,"gold":0.836,"ether":0.352,"silver":1,"bitcoin":0.36,"us_tech":0.685,"emerging":0.687,"ig_credit":0.558,"us_dollar":-0.562,"high_yield":0.582,"real_estate":0.338,"us_equities":0.694,"us_smallcap":0.654,"intl_developed":0.719,"mid_treasuries":0.601,"long_treasuries":0.471,"broad_commodities":-0.219},"bitcoin":{"oil":-0.216,"gold":0.336,"ether":0.899,"silver":0.36,"bitcoin":1,"us_tech":0.478,"emerging":0.42,"ig_credit":0.284,"us_dollar":-0.285,"high_yield":0.319,"real_estate":0.052,"us_equities":0.464,"us_smallcap":0.435,"intl_developed":0.359,"mid_treasuries":0.315,"long_treasuries":0.199,"broad_commodities":-0.153},"us_tech":{"oil":-0.474,"gold":0.655,"ether":0.517,"silver":0.685,"bitcoin":0.478,"us_tech":1,"emerging":0.907,"ig_credit":0.632,"us_dollar":-0.607,"high_yield":0.711,"real_estate":0.261,"us_equities":0.943,"us_smallcap":0.846,"intl_developed":0.801,"mid_treasuries":0.577,"long_treasuries":0.483,"broad_commodities":-0.315},"emerging":{"oil":-0.581,"gold":0.624,"ether":0.489,"silver":0.687,"bitcoin":0.42,"us_tech":0.907,"emerging":1,"ig_credit":0.688,"us_dollar":-0.671,"high_yield":0.748,"real_estate":0.333,"us_equities":0.878,"us_smallcap":0.853,"intl_developed":0.874,"mid_treasuries":0.673,"long_treasuries":0.567,"broad_commodities":-0.43},"ig_credit":{"oil":-0.542,"gold":0.5,"ether":0.285,"silver":0.558,"bitcoin":0.284,"us_tech":0.632,"emerging":0.688,"ig_credit":1,"us_dollar":-0.622,"high_yield":0.901,"real_estate":0.581,"us_equities":0.71,"us_smallcap":0.762,"intl_developed":0.769,"mid_treasuries":0.928,"long_treasuries":0.918,"broad_commodities":-0.504},"us_dollar":{"oil":0.628,"gold":-0.45,"ether":-0.291,"silver":-0.562,"bitcoin":-0.285,"us_tech":-0.607,"emerging":-0.671,"ig_credit":-0.622,"us_dollar":1,"high_yield":-0.717,"real_estate":-0.473,"us_equities":-0.679,"us_smallcap":-0.707,"intl_developed":-0.758,"mid_treasuries":-0.538,"long_treasuries":-0.461,"broad_commodities":0.478},"high_yield":{"oil":-0.568,"gold":0.546,"ether":0.289,"silver":0.582,"bitcoin":0.319,"us_tech":0.711,"emerging":0.748,"ig_credit":0.901,"us_dollar":-0.717,"high_yield":1,"real_estate":0.617,"us_equities":0.802,"us_smallcap":0.841,"intl_developed":0.845,"mid_treasuries":0.839,"long_treasuries":0.739,"broad_commodities":-0.488},"real_estate":{"oil":-0.45,"gold":0.313,"ether":-0.055,"silver":0.338,"bitcoin":0.052,"us_tech":0.261,"emerging":0.333,"ig_credit":0.581,"us_dollar":-0.473,"high_yield":0.617,"real_estate":1,"us_equities":0.447,"us_smallcap":0.509,"intl_developed":0.58,"mid_treasuries":0.588,"long_treasuries":0.564,"broad_commodities":-0.455},"us_equities":{"oil":-0.569,"gold":0.668,"ether":0.465,"silver":0.694,"bitcoin":0.464,"us_tech":0.943,"emerging":0.878,"ig_credit":0.71,"us_dollar":-0.679,"high_yield":0.802,"real_estate":0.447,"us_equities":1,"us_smallcap":0.905,"intl_developed":0.877,"mid_treasuries":0.635,"long_treasuries":0.552,"broad_commodities":-0.423},"us_smallcap":{"oil":-0.599,"gold":0.597,"ether":0.395,"silver":0.654,"bitcoin":0.435,"us_tech":0.846,"emerging":0.853,"ig_credit":0.762,"us_dollar":-0.707,"high_yield":0.841,"real_estate":0.509,"us_equities":0.905,"us_smallcap":1,"intl_developed":0.871,"mid_treasuries":0.695,"long_treasuries":0.622,"broad_commodities":-0.464},"intl_developed":{"oil":-0.674,"gold":0.686,"ether":0.375,"silver":0.719,"bitcoin":0.359,"us_tech":0.801,"emerging":0.874,"ig_credit":0.769,"us_dollar":-0.758,"high_yield":0.845,"real_estate":0.58,"us_equities":0.877,"us_smallcap":0.871,"intl_developed":1,"mid_treasuries":0.737,"long_treasuries":0.65,"broad_commodities":-0.548},"mid_treasuries":{"oil":-0.521,"gold":0.588,"ether":0.302,"silver":0.601,"bitcoin":0.315,"us_tech":0.577,"emerging":0.673,"ig_credit":0.928,"us_dollar":-0.538,"high_yield":0.839,"real_estate":0.588,"us_equities":0.635,"us_smallcap":0.695,"intl_developed":0.737,"mid_treasuries":1,"long_treasuries":0.918,"broad_commodities":-0.486},"long_treasuries":{"oil":-0.499,"gold":0.404,"ether":0.174,"silver":0.471,"bitcoin":0.199,"us_tech":0.483,"emerging":0.567,"ig_credit":0.918,"us_dollar":-0.461,"high_yield":0.739,"real_estate":0.564,"us_equities":0.552,"us_smallcap":0.622,"intl_developed":0.65,"mid_treasuries":0.918,"long_treasuries":1,"broad_commodities":-0.49},"broad_commodities":{"oil":0.92,"gold":-0.187,"ether":-0.072,"silver":-0.219,"bitcoin":-0.153,"us_tech":-0.315,"emerging":-0.43,"ig_credit":-0.504,"us_dollar":0.478,"high_yield":-0.488,"real_estate":-0.455,"us_equities":-0.423,"us_smallcap":-0.464,"intl_developed":-0.548,"mid_treasuries":-0.486,"long_treasuries":-0.49,"broad_commodities":1}},"source":"Yahoo Finance + Binance","window_days":90,"observations":65,"most_correlated":[{"a":"us_equities","b":"us_tech","correlation":0.943},{"a":"mid_treasuries","b":"ig_credit","correlation":0.928},{"a":"oil","b":"broad_commodities","correlation":0.92}],"least_correlated":[{"a":"intl_developed","b":"us_dollar","correlation":-0.758},{"a":"high_yield","b":"us_dollar","correlation":-0.717},{"a":"us_smallcap","b":"us_dollar","correlation":-0.707}]},"meta":{"timestamp":"2026-06-12T10:35:24.892Z","request_id":"ba903240-0c61-45f3-bac2-0a4658adf4ce"},"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/asset":{"get":{"operationId":"get_v1_asset","tags":["Asset"],"summary":"One asset correlation to all others, ranked, with best diversifiers","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/assets)","schema":{"type":"string"},"example":"gold"},{"name":"window","in":"query","required":false,"description":"Lookback in days (20-365)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","label":"US Small Caps","correlation":0.597},{"key":"mid_treasuries","class":"bonds","label":"7-10y US Treasuries","correlation":0.588},{"key":"high_yield","class":"bonds","label":"High-Yield Credit","correlation":0.546},{"key":"ig_credit","class":"bonds","label":"Investment-Grade Credit","correlation":0.5},{"key":"long_treasuries","class":"bonds","label":"Long US Treasuries","correlation":0.404},{"key":"ether","class":"crypto","label":"Ether","correlation":0.343},{"key":"bitcoin","class":"crypto","label":"Bitcoin","correlation":0.336},{"key":"real_estate","class":"real_estate","label":"US Real Estate (REITs)","correlation":0.313},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","correlation":-0.187},{"key":"oil","class":"commodities","label":"Crude Oil","correlation":-0.336},{"key":"us_dollar","class":"currency","label":"US Dollar","correlation":-0.45}],"observations":65,"best_diversifiers":[{"key":"us_dollar","class":"currency","label":"US Dollar","correlation":-0.45},{"key":"oil","class":"commodities","label":"Crude Oil","correlation":-0.336},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","correlation":-0.187}]},"meta":{"timestamp":"2026-06-12T10:35:25.260Z","request_id":"30e03144-639f-49a3-846a-b704b0d813ce"},"status":"ok","message":"Asset correlations 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/assets":{"get":{"operationId":"get_v1_assets","tags":["Assets"],"summary":"Supported cross-asset instruments","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":"High-Yield Credit"},{"key":"gold","class":"commodities","label":"Gold"},{"key":"silver","class":"commodities","label":"Silver"},{"key":"oil","class":"commodities","label":"Crude Oil"},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities"},{"key":"bitcoin","class":"crypto","label":"Bitcoin"},{"key":"ether","class":"crypto","label":"Ether"},{"key":"us_dollar","class":"currency","label":"US Dollar"},{"key":"real_estate","class":"real_estate","label":"US Real Estate (REITs)"}],"source":"Yahoo Finance + Binance","classes":["equities","bonds","commodities","crypto","currency","real_estate"]},"meta":{"timestamp":"2026-06-12T10:35:25.339Z","request_id":"c904aff2-ed88-4edf-a689-eaa6f9189033"},"status":"ok","message":"Assets 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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 the bring-your-own-series CAPM, risk-metrics and portfolio-optimiser calculators.","assets_loaded":17,"upstream_status":"ok","assets_supported":17},"meta":{"timestamp":"2026-06-12T10:35:25.649Z","request_id":"db8fd078-da84-43da-b9c2-125cef764bad"},"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":700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1132,"monthly_call_quota":18000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3422,"monthly_call_quota":90000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7920,"monthly_call_quota":480000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/crossassetcorrelation-api"}