{"openapi":"3.1.0","info":{"title":"Central Bank of Azerbaijan API","version":"1.0.0","description":"Live official exchange-rate data from the Central Bank of the Republic of Azerbaijan (CBAR), the central bank of Azerbaijan, for the Azerbaijani manat (AZN) — uniquely also publishing official bank metal prices: the CBAR official rate for every published currency (normalised to one unit), a single currency's manat-per-unit rate and inverse, the official price of gold, silver, platinum and palladium per troy ounce in manat, and currency conversion between any two published currencies (including AZN) cross-computed through the manat.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cbar-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Metals"},{"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 manat-per-unit rate and inverse","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":"AZN","date":"2026-06-10","name":"1 ABŞ dolları","source":"Central Bank of Azerbaijan","nominal":1,"currency":"USD","azn_per_unit":1.7,"unit_per_azn":0.58823529},"meta":{"timestamp":"2026-06-10T14:00:19.735Z","request_id":"b97a7ae7-75cc-401e-8ddb-770d98048970"},"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":"CBAR official rate for every currency vs the manat","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"AZN","date":"2026-06-10","count":38,"rates":[{"name":"1 BƏƏ dirhəmi","rate":0.4628,"nominal":1,"currency":"AED","azn_per_unit":0.4628},{"name":"1 Avstraliya dolları","rate":1.1929,"nominal":1,"currency":"AUD","azn_per_unit":1.1929},{"name":"1 Belarus rublu","rate":0.6223,"nominal":1,"currency":"BYN","azn_per_unit":0.6223},{"name":"1 Kanada dolları","rate":1.2188,"nominal":1,"currency":"CAD","azn_per_unit":1.2188},{"name":"1 İsveçrə frankı","rate":2.1273,"nominal":1,"currency":"CHF","azn_per_unit":2.1273},{"name":"1 Çin yuanı","rate":0.2509,"nominal":1,"currency":"CNY","azn_per_unit":0.2509},{"name":"1 Çexiya kronu","rate":0.0812,"nominal":1,"currency":"CZK","azn_per_unit":0.0812},{"name":"1 Danimarka kronu","rate":0.2626,"nominal":1,"currency":"DKK","azn_per_unit":0.2626},{"name":"1 Avro","rate":1.9628,"nominal":1,"currency":"EUR","azn_per_unit":1.9628},{"name":"1 İngilis funt sterlinqi","rate":2.2749,"nominal":1,"currency":"GBP","azn_per_unit":2.2749},{"name":"1 Gürcü larisi","rate":0.6402,"nominal":1,"currency":"GEL","azn_per_unit":0.6402},{"name":"1 Honq Konq dolları","rate":0.2169,"nominal":1,"currency":"HKD","azn_per_unit":0.2169},{"name":"100 Macarıstan forinti","rate":0.5515,"nominal":100,"currency":"HUF","azn_per_unit":0.005515},{"name":"1 İsrail şekeli","rate":0.5728,"nominal":1,"currency":"ILS","azn_per_unit":0.5728},{"name":"1 Hindistan rupisi","rate":0.0178,"nominal":1,"currency":"INR","azn_per_unit":0.0178},{"name":"100 Yapon yeni","rate":1.06,"nominal":100,"currency":"JPY","azn_per_unit":0.0106},{"name":"1 Qırğız somu","rate":0.0194,"nominal":1,"currency":"KGS","azn_per_unit":0.0194},{"name":"100 Cənubi Koreya vonu","rate":0.1115,"nominal":100,"currency":"KRW","azn_per_unit":0.001115},{"name":"1 Küveyt dinarı","rate":5.4979,"nominal":1,"currency":"KWD","azn_per_unit":5.4979},{"name":"100 Qazaxıstan tengəsi","rate":0.3485,"nominal":100,"currency":"KZT","azn_per_unit":0.003485},{"name":"1 Moldova leyi","rate":0.0978,"nominal":1,"currency":"MDL","azn_per_unit":0.0978},{"name":"1 Norveç kronu","rate":0.1786,"nominal":1,"currency":"NOK","azn_per_unit":0.1786},{"name":"1 Yeni Zelandiya dolları","rate":0.9884,"nominal":1,"currency":"NZD","azn_per_unit":0.9884},{"name":"100 Pakistan rupisi","rate":0.6101,"nominal":100,"currency":"PKR","azn_per_unit":0.006101},{"name":"1 Polşa zlotısı","rate":0.4624,"nominal":1,"currency":"PLN","azn_per_unit":0.4624},{"name":"1 Qətər rialı","rate":0.4663,"nominal":1,"currency":"QAR","azn_per_unit":0.4663},{"name":"1 Rumıniya leyi","rate":0.3748,"nominal":1,"currency":"RON","azn_per_unit":0.3748},{"name":"1 Serbiya dinarı","rate":0.0167,"nominal":1,"currency":"RSD","azn_per_unit":0.0167},{"name":"100 Rusiya rublu","rate":2.3656,"nominal":100,"currency":"RUB","azn_per_unit":0.023656},{"name":"1 Səudiyyə Ərəbistanı rialı","rate":0.4528,"nominal":1,"currency":"SAR","azn_per_unit":0.4528},{"name":"1 SDR (BVF-nin xüsusi borcalma hüquqları)","rate":2.3207,"nominal":1,"currency":"SDR","azn_per_unit":2.3207},{"name":"1 İsveç kronu","rate":0.1794,"nominal":1,"currency":"SEK","azn_per_unit":0.1794},{"name":"1 Sinqapur dolları","rate":1.3203,"nominal":1,"currency":"SGD","azn_per_unit":1.3203},{"name":"1 Türkmənistan manatı","rate":0.4857,"nominal":1,"currency":"TMT","azn_per_unit":0.4857},{"name":"1 Türk lirəsi","rate":0.0369,"nominal":1,"currency":"TRY","azn_per_unit":0.0369},{"name":"1 Ukrayna qrivnası","rate":0.0378,"nominal":1,"currency":"UAH","azn_per_unit":0.0378},{"name":"1 ABŞ dolları","rate":1.7,"nominal":1,"currency":"USD","azn_per_unit":1.7},{"name":"100 Özbək somu","rate":0.0141,"nominal":100,"currency":"UZS","azn_per_unit":0.000141}],"source":"Central Bank of Azerbaijan"},"meta":{"timestamp":"2026-06-10T14:00:19.957Z","request_id":"6a0aa78b-24c0-49c1-9979-b8f964c563e7"},"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/metals":{"get":{"operationId":"get_v1_metals","tags":["Metals"],"summary":"Official gold, silver, platinum and palladium prices in manat","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"AZN","date":"2026-06-10","count":4,"metals":[{"code":"XAG","unit":"troy ounce","metal":"Silver","azn_per_ounce":107.8813},{"code":"XAU","unit":"troy ounce","metal":"Gold","azn_per_ounce":7096.1485},{"code":"XPD","unit":"troy ounce","metal":"Palladium","azn_per_ounce":2041.598},{"code":"XPT","unit":"troy ounce","metal":"Platinum","azn_per_ounce":2817.393}],"source":"Central Bank of Azerbaijan"},"meta":{"timestamp":"2026-06-10T14:00:20.192Z","request_id":"8d0ddb16-f99b-4d16-b6fa-91fdaadc33a9"},"status":"ok","message":"Metals 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 CBAR 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.86610964,"amount":100,"result":86.610964,"source":"Central Bank of Azerbaijan","azn_per_to":1.9628,"azn_per_from":1.7},"meta":{"timestamp":"2026-06-10T14:00:20.412Z","request_id":"76b70237-96fb-4abe-b480-0a1e3c47b35b"},"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 Azerbaijan daily rate file (cbar.az, live)","service":"cbar-api","usd_azn":1.7,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, manat-per-unit and inverse (currency=USD).","GET /v1/rates":"The CBAR official rate for every currency vs the manat.","GET /v1/metals":"Official gold, silver, platinum and palladium prices per troy ounce in manat.","GET /v1/convert":"Convert an amount between two currencies at CBAR rates (from=USD, to=EUR, amount=100)."},"description":"Live official exchange-rate data from the Central Bank of the Republic of Azerbaijan (CBAR), the central bank of Azerbaijan, for the Azerbaijani manat (AZN), via its public daily rate file — uniquely also publishing official bank metal prices. The rates endpoint returns the CBAR's official rate for every published currency against the manat, normalised to one unit; the rate endpoint returns a single currency's official rate (manat-per-unit and the inverse); the metals endpoint returns the official price of gold, silver, platinum and palladium per troy ounce in manat; the convert endpoint converts an amount between any two published currencies (including AZN) at the CBAR's official rates, cross-computed through the manat. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU and other central-bank feeds and from market mid-rates — this is the Central Bank of Azerbaijan's own official manat rate plus official bank-metal prices.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:00:20.623Z","request_id":"6532018b-418b-412a-a307-a81b7f366d46"},"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":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":166000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":1040000,"rps_limit":12,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5200,"monthly_call_quota":5450000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cbar-api"}