{"openapi":"3.1.0","info":{"title":"Currency Correlation API","version":"1.0.0","description":"A live forex correlation analytic as an API, computed from European Central Bank daily reference rates. It measures how the world's currencies move together: each currency's daily appreciation is correlated against every other, so you can see which currencies move in lock-step (don't double up the same risk) and which move opposite (natural hedges). Get one currency's correlations to all others ranked, the coefficient for any pair, or a full correlation matrix for a basket. Risk and diversification input for forex, portfolio and trading apps. Live, no key. Distinct from currency-strength (direction) and FX-volatility (magnitude) — this is co-movement.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/currencycorrelation-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/currency":{"get":{"operationId":"get_v1_currency","tags":["Correlation"],"summary":"One currency correlations to all others","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"3-letter currency code","schema":{"type":"string"},"example":"AUD"},{"name":"period","in":"query","required":false,"description":"1m | 3m | 6m | 1y","schema":{"type":"string"},"example":"3m"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":28,"period":"3m","to_date":"2026-06-08","currency":"AUD","from_date":"2026-03-06","correlations":[{"currency":"ZAR","correlation":0.619,"relationship":"moderate positive"},{"currency":"MXN","correlation":0.498,"relationship":"moderate positive"},{"currency":"NZD","correlation":0.497,"relationship":"moderate positive"},{"currency":"PLN","correlation":0.419,"relationship":"moderate positive"},{"currency":"BRL","correlation":0.401,"relationship":"moderate positive"},{"currency":"GBP","correlation":0.401,"relationship":"moderate positive"},{"currency":"SEK","correlation":0.365,"relationship":"moderate positive"},{"currency":"CZK","correlation":0.28,"relationship":"weak"},{"currency":"CHF","correlation":0.27,"relationship":"weak"},{"currency":"MYR","correlation":0.27,"relationship":"weak"},{"currency":"THB","correlation":0.27,"relationship":"weak"},{"currency":"NOK","correlation":0.266,"relationship":"weak"},{"currency":"HUF","correlation":0.253,"relationship":"weak"},{"currency":"ILS","correlation":0.243,"relationship":"weak"},{"currency":"KRW","correlation":0.179,"relationship":"weak"},{"currency":"PHP","correlation":0.058,"relationship":"weak"},{"currency":"RON","correlation":0.029,"relationship":"weak"},{"currency":"ISK","correlation":0.026,"relationship":"weak"},{"currency":"SGD","correlation":-0.011,"relationship":"weak"},{"currency":"CAD","correlation":-0.066,"relationship":"weak"},{"currency":"INR","correlation":-0.077,"relationship":"weak"},{"currency":"CNY","correlation":-0.102,"relationship":"weak"},{"currency":"DKK","correlation":-0.132,"relationship":"weak"},{"currency":"IDR","correlation":-0.14,"relationship":"weak"},{"currency":"JPY","correlation":-0.179,"relationship":"weak"},{"currency":"TRY","correlation":-0.275,"relationship":"weak"},{"currency":"USD","correlation":-0.33,"relationship":"moderate negative"},{"currency":"HKD","correlation":-0.354,"relationship":"moderate negative"}],"observations":64},"meta":{"timestamp":"2026-06-09T03:03:35.189Z","request_id":"6ae6b53d-ab7c-49cc-90c1-7f6c3e7e8a15"},"status":"ok","message":"Currency 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/matrix":{"get":{"operationId":"get_v1_matrix","tags":["Correlation"],"summary":"Correlation matrix for a basket","description":"","parameters":[{"name":"currencies","in":"query","required":false,"description":"Comma-separated codes (or default basket)","schema":{"type":"string"},"example":"USD,JPY,GBP,AUD,CAD"},{"name":"period","in":"query","required":false,"description":"1m | 3m | 6m | 1y","schema":{"type":"string"},"example":"3m"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"matrix":{"AUD":{"AUD":1,"CAD":-0.066,"GBP":0.401,"JPY":-0.179,"USD":-0.33},"CAD":{"AUD":-0.066,"CAD":1,"GBP":0.081,"JPY":0.254,"USD":0.74},"GBP":{"AUD":0.401,"CAD":0.081,"GBP":1,"JPY":-0.011,"USD":-0.141},"JPY":{"AUD":-0.179,"CAD":0.254,"GBP":-0.011,"JPY":1,"USD":0.397},"USD":{"AUD":-0.33,"CAD":0.74,"GBP":-0.141,"JPY":0.397,"USD":1}},"period":"3m","to_date":"2026-06-08","from_date":"2026-03-06","currencies":["USD","JPY","GBP","AUD","CAD"],"observations":64},"meta":{"timestamp":"2026-06-09T03:03:35.414Z","request_id":"3e16a7f4-4e63-41e8-ae3a-4f7d7ce68b6f"},"status":"ok","message":"Correlation 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 coefficient for a pair","description":"","parameters":[{"name":"base","in":"query","required":true,"description":"First currency","schema":{"type":"string"},"example":"AUD"},{"name":"quote","in":"query","required":true,"description":"Second currency","schema":{"type":"string"},"example":"NZD"},{"name":"period","in":"query","required":false,"description":"1m | 3m | 6m | 1y","schema":{"type":"string"},"example":"3m"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"AUD","quote":"NZD","period":"3m","to_date":"2026-06-08","from_date":"2026-03-06","correlation":0.497,"observations":64,"relationship":"moderate positive"},"meta":{"timestamp":"2026-06-09T03:03:35.515Z","request_id":"6c9cc491-df60-49a2-9dba-388fef7a4e4b"},"status":"ok","message":"Pair correlation 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":{"method":"Pearson correlation of daily appreciation (vs EUR) log-returns","source":"ECB daily reference rates via Frankfurter (live)","periods":["1m","3m","6m","1y"],"service":"currencycorrelation-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pair":"Correlation coefficient for a pair (base=USD&quote=JPY, period=).","GET /v1/matrix":"Correlation matrix for a basket (currencies=USD,JPY,GBP… or default, period=).","GET /v1/currency":"One currency's correlations to all others, ranked (code=USD, period=1m|3m|6m|1y)."},"description":"Live FX correlation analytic from ECB reference rates (Frankfurter): how currencies' daily moves co-vary. Get one currency's correlations to all others, the coefficient for any pair, or a full correlation matrix for a basket. Live, no key. Distinct from currency-strength (direction) and FX-volatility (magnitude).","default_basket":["USD","JPY","GBP","AUD","CAD","CHF","CNY","NZD","SEK","NOK"],"currencies_live":29},"meta":{"timestamp":"2026-06-09T03:03:35.680Z","request_id":"d0dc73f7-f5b6-478a-b374-2272b33efc07"},"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":300,"rps_limit":3,"hard_limit":true},{"slug":"trader","name":"Trader","price_cents_month":800,"monthly_call_quota":10000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":52000,"rps_limit":25,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5200,"monthly_call_quota":260000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/currencycorrelation-api"}