{"openapi":"3.1.0","info":{"title":"Central Bank of Uzbekistan API","version":"1.0.0","description":"Live official exchange-rate data from the Central Bank of the Republic of Uzbekistan (CBU), the central bank of Uzbekistan, for the Uzbek soum (UZS) — one of the widest official rate lists of any central bank (over 70 currencies), each with its daily change: the CBU official rate for every published currency (normalised to one unit) with the day's change, a single currency's soum-per-unit rate and inverse plus daily change, a currency's official rate on a specific past date, and currency conversion between any two published currencies (including UZS) cross-computed through the soum.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cbu-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"History"},{"name":"Convert"},{"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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rates"],"summary":"One currency soum-per-unit rate, inverse and daily change","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"UZS","date":"2026-06-10","name":"US Dollar","source":"Central Bank of Uzbekistan","nominal":1,"currency":"USD","code_numeric":840,"daily_change":21.82,"unit_per_uzs":8.30895e-5,"uzs_per_unit":12035.22},"meta":{"timestamp":"2026-06-10T14:01:27.793Z","request_id":"38bdd863-83b5-42a2-9fb8-882843565ac3"},"status":"ok","message":"Rate 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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"CBU official rate for every currency vs the soum","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"UZS","date":"2026-06-10","count":74,"rates":[{"date":"2026-06-10","name":"UAE Dirham","rate":3276.58,"nominal":1,"currency":"AED","code_numeric":784,"daily_change":5.58,"uzs_per_unit":3276.58},{"date":"2026-06-10","name":"AF Afghani","rate":187.38,"nominal":1,"currency":"AFN","code_numeric":971,"daily_change":-0.95,"uzs_per_unit":187.38},{"date":"2026-06-10","name":"Armenian Dram","rate":32.66,"nominal":1,"currency":"AMD","code_numeric":51,"daily_change":0.06,"uzs_per_unit":32.66},{"date":"2026-06-10","name":"Argentine Peso","rate":8.32,"nominal":1,"currency":"ARS","code_numeric":32,"daily_change":-0.02,"uzs_per_unit":8.32},{"date":"2026-06-10","name":"Australian Dollar","rate":8484.83,"nominal":1,"currency":"AUD","code_numeric":36,"daily_change":12.98,"uzs_per_unit":8484.83},{"date":"2026-06-10","name":"Azerbaijan Manat","rate":7079.54,"nominal":1,"currency":"AZN","code_numeric":944,"daily_change":12.83,"uzs_per_unit":7079.54},{"date":"2026-06-10","name":"Bangladesh Taka","rate":97.91,"nominal":1,"currency":"BDT","code_numeric":50,"daily_change":0.04,"uzs_per_unit":97.91},{"date":"2026-06-10","name":"Bahraini Dinar","rate":31915.19,"nominal":1,"currency":"BHD","code_numeric":48,"daily_change":57.86,"uzs_per_unit":31915.19},{"date":"2026-06-10","name":"Brunei Dollar","rate":9360.83,"nominal":1,"currency":"BND","code_numeric":96,"daily_change":43.06,"uzs_per_unit":9360.83},{"date":"2026-06-10","name":"Brazilian Real","rate":2317.59,"nominal":1,"currency":"BRL","code_numeric":986,"daily_change":-5.23,"uzs_per_unit":2317.59},{"date":"2026-06-10","name":"Belarusian Ruble","rate":4366.44,"nominal":1,"currency":"BYN","code_numeric":933,"daily_change":81.14,"uzs_per_unit":4366.44},{"date":"2026-06-10","name":"Canadian Dollar","rate":8635.45,"nominal":1,"currency":"CAD","code_numeric":124,"daily_change":21.84,"uzs_per_unit":8635.45},{"date":"2026-06-10","name":"Swiss Franc","rate":15112.03,"nominal":1,"currency":"CHF","code_numeric":756,"daily_change":57.64,"uzs_per_unit":15112.03},{"date":"2026-06-10","name":"Yuan Renminbi","rate":1777.6,"nominal":1,"currency":"CNY","code_numeric":156,"daily_change":6.68,"uzs_per_unit":1777.6},{"date":"2026-06-10","name":"Cuban Peso","rate":501.47,"nominal":1,"currency":"CUP","code_numeric":192,"daily_change":0.91,"uzs_per_unit":501.47},{"date":"2026-06-10","name":"Czech Koruna","rate":575.24,"nominal":1,"currency":"CZK","code_numeric":203,"daily_change":4.37,"uzs_per_unit":575.24},{"date":"2026-06-10","name":"Danish Krone","rate":1861.6,"nominal":1,"currency":"DKK","code_numeric":208,"daily_change":11.08,"uzs_per_unit":1861.6},{"date":"2026-06-10","name":"Algerian Dinar","rate":90.08,"nominal":1,"currency":"DZD","code_numeric":12,"daily_change":0.3,"uzs_per_unit":90.08},{"date":"2026-06-10","name":"Egyptian Pound","rate":232.79,"nominal":1,"currency":"EGP","code_numeric":818,"daily_change":2.47,"uzs_per_unit":232.79},{"date":"2026-06-10","name":"Euro","rate":13915.12,"nominal":1,"currency":"EUR","code_numeric":978,"daily_change":84.09,"uzs_per_unit":13915.12},{"date":"2026-06-10","name":"Pound Sterling","rate":16112.75,"nominal":1,"currency":"GBP","code_numeric":826,"daily_change":102.49,"uzs_per_unit":16112.75},{"date":"2026-06-10","name":"Georgian Lari","rate":4536.46,"nominal":1,"currency":"GEL","code_numeric":981,"daily_change":11.64,"uzs_per_unit":4536.46},{"date":"2026-06-10","name":"Hong Kong Dollar","rate":1535.73,"nominal":1,"currency":"HKD","code_numeric":344,"daily_change":2.59,"uzs_per_unit":1535.73},{"date":"2026-06-10","name":"Hungarian Forint","rate":39.19,"nominal":1,"currency":"HUF","code_numeric":348,"daily_change":0.41,"uzs_per_unit":39.19},{"date":"2026-06-10","name":"Rupiah","rate":6.67,"nominal":10,"currency":"IDR","code_numeric":360,"daily_change":0.06,"uzs_per_unit":0.667},{"date":"2026-06-10","name":"New Israeli Sheqel","rate":4093.75,"nominal":1,"currency":"ILS","code_numeric":376,"daily_change":10.75,"uzs_per_unit":4093.75},{"date":"2026-06-10","name":"Indian Rupee","rate":126.2,"nominal":1,"currency":"INR","code_numeric":356,"daily_change":0.68,"uzs_per_unit":126.2},{"date":"2026-06-10","name":"Iraqi Dinar","rate":9.19,"nominal":1,"currency":"IQD","code_numeric":368,"daily_change":0.02,"uzs_per_unit":9.19},{"date":"2026-06-10","name":"Iranian Rial","rate":0.09,"nominal":10,"currency":"IRR","code_numeric":364,"daily_change":0,"uzs_per_unit":0.009},{"date":"2026-06-10","name":"Iceland Krona","rate":97.03,"nominal":1,"currency":"ISK","code_numeric":352,"daily_change":0.71,"uzs_per_unit":97.03},{"date":"2026-06-10","name":"Jordanian Dinar","rate":16974.92,"nominal":1,"currency":"JOD","code_numeric":400,"daily_change":30.77,"uzs_per_unit":16974.92},{"date":"2026-06-10","name":"Japan Yen","rate":75.13,"nominal":1,"currency":"JPY","code_numeric":392,"daily_change":0.05,"uzs_per_unit":75.13},{"date":"2026-06-10","name":"Kyrgyzstan Som","rate":137.58,"nominal":1,"currency":"KGS","code_numeric":417,"daily_change":0.25,"uzs_per_unit":137.58},{"date":"2026-06-10","name":"Riel","rate":3,"nominal":1,"currency":"KHR","code_numeric":116,"daily_change":0.01,"uzs_per_unit":3},{"date":"2026-06-10","name":"The Korean Republic Won","rate":7.91,"nominal":1,"currency":"KRW","code_numeric":410,"daily_change":0.08,"uzs_per_unit":7.91},{"date":"2026-06-10","name":"Kuwaiti Dinar","rate":39164.4,"nominal":1,"currency":"KWD","code_numeric":414,"daily_change":71.01,"uzs_per_unit":39164.4},{"date":"2026-06-10","name":"Kazakhstan Tenge","rate":24.59,"nominal":1,"currency":"KZT","code_numeric":398,"daily_change":-0.15,"uzs_per_unit":24.59},{"date":"2026-06-10","name":"Lao Kip","rate":0.55,"nominal":1,"currency":"LAK","code_numeric":418,"daily_change":0,"uzs_per_unit":0.55},{"date":"2026-06-10","name":"Lebanese Pound","rate":0.13,"nominal":1,"currency":"LBP","code_numeric":422,"daily_change":0,"uzs_per_unit":0.13},{"date":"2026-06-10","name":"Libyan Dinar","rate":1882.27,"nominal":1,"currency":"LYD","code_numeric":434,"daily_change":-6.99,"uzs_per_unit":1882.27},{"date":"2026-06-10","name":"Moroccan Dirham","rate":1301.81,"nominal":1,"currency":"MAD","code_numeric":504,"daily_change":5.71,"uzs_per_unit":1301.81},{"date":"2026-06-10","name":"Moldovan Leu","rate":692.08,"nominal":1,"currency":"MDL","code_numeric":498,"daily_change":2.84,"uzs_per_unit":692.08},{"date":"2026-06-10","name":"Kyat","rate":5.73,"nominal":1,"currency":"MMK","code_numeric":104,"daily_change":0.01,"uzs_per_unit":5.73},{"date":"2026-06-10","name":"Tugrik","rate":3.36,"nominal":1,"currency":"MNT","code_numeric":496,"daily_change":0,"uzs_per_unit":3.36},{"date":"2026-06-10","name":"Mexican Peso","rate":691.98,"nominal":1,"currency":"MXN","code_numeric":484,"daily_change":3.87,"uzs_per_unit":691.98},{"date":"2026-06-10","name":"Malaysian Ringgit","rate":2963.61,"nominal":1,"currency":"MYR","code_numeric":458,"daily_change":14.45,"uzs_per_unit":2963.61},{"date":"2026-06-10","name":"Norwegian Krone","rate":1271.2,"nominal":1,"currency":"NOK","code_numeric":578,"daily_change":1.2,"uzs_per_unit":1271.2},{"date":"2026-06-10","name":"New Zealand Dollar","rate":7017.74,"nominal":1,"currency":"NZD","code_numeric":554,"daily_change":37.95,"uzs_per_unit":7017.74},{"date":"2026-06-10","name":"Rial Omani","rate":31260.31,"nominal":1,"currency":"OMR","code_numeric":512,"daily_change":56.67,"uzs_per_unit":31260.31},{"date":"2026-06-10","name":"Philippine Piso","rate":195.82,"nominal":1,"currency":"PHP","code_numeric":608,"daily_change":1.05,"uzs_per_unit":195.82},{"date":"2026-06-10","name":"Pakistan Rupee","rate":43.25,"nominal":1,"currency":"PKR","code_numeric":586,"daily_change":0.09,"uzs_per_unit":43.25},{"date":"2026-06-10","name":"Polish Zloty","rate":3284.63,"nominal":1,"currency":"PLN","code_numeric":985,"daily_change":27.02,"uzs_per_unit":3284.63},{"date":"2026-06-10","name":"Qatari Rial","rate":3301.21,"nominal":1,"currency":"QAR","code_numeric":634,"daily_change":5.99,"uzs_per_unit":3301.21},{"date":"2026-06-10","name":"Romanian Leu","rate":2655.96,"nominal":1,"currency":"RON","code_numeric":946,"daily_change":18.49,"uzs_per_unit":2655.96},{"date":"2026-06-10","name":"Serbian Dinar","rate":118.53,"nominal":1,"currency":"RSD","code_numeric":941,"daily_change":0.7,"uzs_per_unit":118.53},{"date":"2026-06-10","name":"Russian Ruble","rate":167.95,"nominal":1,"currency":"RUB","code_numeric":643,"daily_change":4.08,"uzs_per_unit":167.95},{"date":"2026-06-10","name":"Saudi Riyal","rate":3205.37,"nominal":1,"currency":"SAR","code_numeric":682,"daily_change":6.49,"uzs_per_unit":3205.37},{"date":"2026-06-10","name":"Sudanese Pound","rate":20.05,"nominal":1,"currency":"SDG","code_numeric":938,"daily_change":0.03,"uzs_per_unit":20.05},{"date":"2026-06-10","name":"Swedish Krona","rate":1277.1,"nominal":1,"currency":"SEK","code_numeric":752,"daily_change":7.05,"uzs_per_unit":1277.1},{"date":"2026-06-10","name":"Singapore Dollar","rate":9360.83,"nominal":1,"currency":"SGD","code_numeric":702,"daily_change":43.06,"uzs_per_unit":9360.83},{"date":"2026-06-10","name":"Syrian Pound","rate":104.18,"nominal":1,"currency":"SYP","code_numeric":760,"daily_change":0.17,"uzs_per_unit":104.18},{"date":"2026-06-10","name":"Baht","rate":366.42,"nominal":1,"currency":"THB","code_numeric":764,"daily_change":0.6,"uzs_per_unit":366.42},{"date":"2026-06-10","name":"Tajikistan Somoni","rate":1289.26,"nominal":1,"currency":"TJS","code_numeric":972,"daily_change":3.03,"uzs_per_unit":1289.26},{"date":"2026-06-10","name":"Turkmenistan New Manat","rate":3438.63,"nominal":1,"currency":"TMT","code_numeric":934,"daily_change":6.23,"uzs_per_unit":3438.63},{"date":"2026-06-10","name":"Tunisian Dinar","rate":4122.07,"nominal":1,"currency":"TND","code_numeric":788,"daily_change":16.61,"uzs_per_unit":4122.07},{"date":"2026-06-10","name":"Turkish Lira","rate":260.95,"nominal":1,"currency":"TRY","code_numeric":949,"daily_change":0.36,"uzs_per_unit":260.95},{"date":"2026-06-10","name":"Ukrainian Hryvnia","rate":267.99,"nominal":1,"currency":"UAH","code_numeric":980,"daily_change":-1.32,"uzs_per_unit":267.99},{"date":"2026-06-10","name":"US Dollar","rate":12035.22,"nominal":1,"currency":"USD","code_numeric":840,"daily_change":21.82,"uzs_per_unit":12035.22},{"date":"2026-06-10","name":"Peso Uruguayo","rate":297.28,"nominal":1,"currency":"UYU","code_numeric":858,"daily_change":-1,"uzs_per_unit":297.28},{"date":"2026-06-10","name":"Bolívar","rate":21.23,"nominal":1,"currency":"VES","code_numeric":928,"daily_change":0.04,"uzs_per_unit":21.23},{"date":"2026-06-10","name":"Dong","rate":4.57,"nominal":10,"currency":"VND","code_numeric":704,"daily_change":0.01,"uzs_per_unit":0.457},{"date":"2026-06-10","name":"SDR","rate":16402.23,"nominal":1,"currency":"XDR","code_numeric":960,"daily_change":-40.99,"uzs_per_unit":16402.23},{"date":"2026-06-10","name":"Yemeni Rial","rate":50.45,"nominal":1,"currency":"YER","code_numeric":886,"daily_change":0.09,"uzs_per_unit":50.45},{"date":"2026-06-10","name":"Rand","rate":731.07,"nominal":1,"currency":"ZAR","code_numeric":710,"daily_change":4.54,"uzs_per_unit":731.07}],"source":"Central Bank of Uzbekistan"},"meta":{"timestamp":"2026-06-10T14:01:28.143Z","request_id":"9aa52ca5-e3de-47ef-bbe8-6c0c559bee5c"},"status":"ok","message":"Rates 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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"A currency official rate on a specific past date","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"UZS","date":"2026-05-15","name":"US Dollar","source":"Central Bank of Uzbekistan","nominal":1,"currency":"USD","daily_change":-98.06,"unit_per_uzs":8.35048e-5,"uzs_per_unit":11975.36},"meta":{"timestamp":"2026-06-10T14:01:28.411Z","request_id":"9d1c2266-6767-4b79-97c8-568906d3127b"},"status":"ok","message":"History 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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies at CBU rates","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","date":"2026-06-10","from":"USD","rate":0.86490235,"amount":100,"result":86.490235,"source":"Central Bank of Uzbekistan","uzs_per_to":13915.12,"uzs_per_from":12035.22},"meta":{"timestamp":"2026-06-10T14:01:28.662Z","request_id":"027bf6de-5bdc-4cac-9d41-a7bf7f632fd1"},"status":"ok","message":"Conversion completed 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Central Bank of Uzbekistan API (cbu.uz, live)","service":"cbu-api","usd_uzs":12035.22,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, soum-per-unit and inverse, plus daily change (currency=USD).","GET /v1/rates":"The CBU official rate for every currency vs the soum, with daily change.","GET /v1/convert":"Convert an amount between two currencies at CBU rates (from=USD, to=EUR, amount=100).","GET /v1/history":"A currency's official rate on a specific past date (currency=USD, date=2026-05-15)."},"description":"Live official exchange-rate data from the Central Bank of the Republic of Uzbekistan (CBU), the central bank of Uzbekistan, for the Uzbek soum (UZS), via its public API — one of the widest official rate lists of any central bank (over 70 currencies), each with its daily change. The rates endpoint returns the CBU's official rate for every published currency against the soum, normalised to one unit, with the day's change; the rate endpoint returns a single currency's official rate (soum-per-unit and the inverse) plus the daily change; the history endpoint returns a currency's official rate on a specific past date; the convert endpoint converts an amount between any two published currencies (including UZS) at the CBU's official rates, cross-computed through the soum. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR, Riksbank, NBU, HNB, NBG and NBRB feeds and from market mid-rates — this is the Central Bank of Uzbekistan's own official soum exchange rate with daily change.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:28.903Z","request_id":"584d8b3d-a23b-49c9-a9a3-c22d094c9305"},"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":14000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":175000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":1070000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4800,"monthly_call_quota":5700000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cbu-api"}