{"openapi":"3.1.0","info":{"title":"Nepal Rastra Bank FX API","version":"1.0.0","description":"Live official exchange-rate data for the Nepalese rupee (NPR) from Nepal Rastra Bank (NRB), the central bank of Nepal — straight from its public Foreign Exchange Rate API as clean JSON. Get the NRB's official buy and sell rate for every published currency against the rupee for the latest (or any past) day, normalised to one unit; pull a single currency's buy, sell and mid rate and the inverse; retrieve a currency's daily NRB buy/sell rate over a date range; convert an amount between any two quoted currencies (including NPR) at the NRB's mid rate; or list the NRB's quoted currencies. Read live from the NRB, nothing cached. Note the NRB quotes both a buy and a sell rate, and some currencies (such as the Indian rupee) are quoted per 100 units — every rate is also normalised to one unit for you. This is the official Nepalese-rupee central-bank rate — distinct from the ECB, BCRA, BCRP and other central-bank feeds and from market mid-rates: the NRB's own published rupee buy/sell rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nrb-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Rate"},{"name":"History"},{"name":"Convert"},{"name":"Currencies"},{"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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"NRB official buy/sell for every currency vs the rupee","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Day YYYY-MM-DD (defaults to latest)","schema":{"type":"string"},"example":"2026-06-09"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"NPR","date":"2026-06-09","count":22,"rates":[{"name":"UAE Dirham","unit":1,"buy_raw":41.61,"currency":"AED","sell_raw":41.77,"npr_buy_per_unit":41.61,"npr_mid_per_unit":41.69,"npr_sell_per_unit":41.77},{"name":"Australian Dollar","unit":1,"buy_raw":108.12,"currency":"AUD","sell_raw":108.54,"npr_buy_per_unit":108.12,"npr_mid_per_unit":108.33,"npr_sell_per_unit":108.54},{"name":"Bahrain Dinar","unit":1,"buy_raw":405.3,"currency":"BHD","sell_raw":406.89,"npr_buy_per_unit":405.3,"npr_mid_per_unit":406.095,"npr_sell_per_unit":406.89},{"name":"Canadian Dollar","unit":1,"buy_raw":109.7,"currency":"CAD","sell_raw":110.13,"npr_buy_per_unit":109.7,"npr_mid_per_unit":109.915,"npr_sell_per_unit":110.13},{"name":"Swiss Franc","unit":1,"buy_raw":192,"currency":"CHF","sell_raw":192.75,"npr_buy_per_unit":192,"npr_mid_per_unit":192.375,"npr_sell_per_unit":192.75},{"name":"Chinese Yuan","unit":1,"buy_raw":22.53,"currency":"CNY","sell_raw":22.62,"npr_buy_per_unit":22.53,"npr_mid_per_unit":22.575,"npr_sell_per_unit":22.62},{"name":"Danish Kroner","unit":1,"buy_raw":23.6,"currency":"DKK","sell_raw":23.69,"npr_buy_per_unit":23.6,"npr_mid_per_unit":23.645,"npr_sell_per_unit":23.69},{"name":"European Euro","unit":1,"buy_raw":176.39,"currency":"EUR","sell_raw":177.09,"npr_buy_per_unit":176.39,"npr_mid_per_unit":176.74,"npr_sell_per_unit":177.09},{"name":"UK Pound Sterling","unit":1,"buy_raw":204.26,"currency":"GBP","sell_raw":205.06,"npr_buy_per_unit":204.26,"npr_mid_per_unit":204.66,"npr_sell_per_unit":205.06},{"name":"Hong Kong Dollar","unit":1,"buy_raw":19.5,"currency":"HKD","sell_raw":19.58,"npr_buy_per_unit":19.5,"npr_mid_per_unit":19.54,"npr_sell_per_unit":19.58},{"name":"Indian Rupee","unit":100,"buy_raw":160,"currency":"INR","sell_raw":160.15,"npr_buy_per_unit":1.6,"npr_mid_per_unit":1.60075,"npr_sell_per_unit":1.6015},{"name":"Japanese Yen","unit":10,"buy_raw":9.55,"currency":"JPY","sell_raw":9.59,"npr_buy_per_unit":0.955,"npr_mid_per_unit":0.957,"npr_sell_per_unit":0.959},{"name":"South Korean Won","unit":100,"buy_raw":9.99,"currency":"KRW","sell_raw":10.03,"npr_buy_per_unit":0.0999,"npr_mid_per_unit":0.1001,"npr_sell_per_unit":0.1003},{"name":"Kuwaity Dinar","unit":1,"buy_raw":497.45,"currency":"KWD","sell_raw":499.4,"npr_buy_per_unit":497.45,"npr_mid_per_unit":498.425,"npr_sell_per_unit":499.4},{"name":"Malaysian Ringgit","unit":1,"buy_raw":37.52,"currency":"MYR","sell_raw":37.67,"npr_buy_per_unit":37.52,"npr_mid_per_unit":37.595,"npr_sell_per_unit":37.67},{"name":"Omani Rial","unit":1,"buy_raw":396.97,"currency":"OMR","sell_raw":398.52,"npr_buy_per_unit":396.97,"npr_mid_per_unit":397.745,"npr_sell_per_unit":398.52},{"name":"Qatari Riyal","unit":1,"buy_raw":41.92,"currency":"QAR","sell_raw":42.09,"npr_buy_per_unit":41.92,"npr_mid_per_unit":42.005,"npr_sell_per_unit":42.09},{"name":"Saudi Arabian Riyal","unit":1,"buy_raw":40.7,"currency":"SAR","sell_raw":40.86,"npr_buy_per_unit":40.7,"npr_mid_per_unit":40.78,"npr_sell_per_unit":40.86},{"name":"Swedish Kroner","unit":1,"buy_raw":16.23,"currency":"SEK","sell_raw":16.29,"npr_buy_per_unit":16.23,"npr_mid_per_unit":16.26,"npr_sell_per_unit":16.29},{"name":"Singapore Dollar","unit":1,"buy_raw":118.72,"currency":"SGD","sell_raw":119.18,"npr_buy_per_unit":118.72,"npr_mid_per_unit":118.95,"npr_sell_per_unit":119.18},{"name":"Thai Baht","unit":1,"buy_raw":4.66,"currency":"THB","sell_raw":4.68,"npr_buy_per_unit":4.66,"npr_mid_per_unit":4.67,"npr_sell_per_unit":4.68},{"name":"U.S. Dollar","unit":1,"buy_raw":152.84,"currency":"USD","sell_raw":153.44,"npr_buy_per_unit":152.84,"npr_mid_per_unit":153.14,"npr_sell_per_unit":153.44}],"source":"Nepal Rastra Bank","published_on":"2026-06-09 00:00:56"},"meta":{"timestamp":"2026-06-10T13:59:05.736Z","request_id":"735b37ae-d8dc-48ad-bd87-18e3883100a8"},"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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"One currency's buy, sell, mid and inverse","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"ISO 4217 currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"NPR","date":"2026-06-10","name":"U.S. Dollar","unit":1,"source":"Nepal Rastra Bank","buy_raw":152.27,"currency":"USD","sell_raw":152.87,"unit_per_npr":0.00655437,"npr_buy_per_unit":152.27,"npr_mid_per_unit":152.57,"npr_sell_per_unit":152.87},"meta":{"timestamp":"2026-06-10T13:59:06.758Z","request_id":"7a8a083f-6100-4ff0-9ea1-f07adfdf34aa"},"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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"A currency's daily buy/sell rate over a date range","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"ISO 4217 currency code","schema":{"type":"string"},"example":"USD"},{"name":"from","in":"query","required":true,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"to","in":"query","required":true,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","base":"NPR","from":"2026-06-01","count":8,"source":"Nepal Rastra Bank","history":[{"date":"2026-06-01","npr_buy_per_unit":151.71,"npr_mid_per_unit":152.01,"npr_sell_per_unit":152.31},{"date":"2026-06-02","npr_buy_per_unit":151.69,"npr_mid_per_unit":151.99,"npr_sell_per_unit":152.29},{"date":"2026-06-03","npr_buy_per_unit":152.13,"npr_mid_per_unit":152.43,"npr_sell_per_unit":152.73},{"date":"2026-06-04","npr_buy_per_unit":152.84,"npr_mid_per_unit":153.14,"npr_sell_per_unit":153.44},{"date":"2026-06-05","npr_buy_per_unit":152.96,"npr_mid_per_unit":153.26,"npr_sell_per_unit":153.56},{"date":"2026-06-06","npr_buy_per_unit":151.62,"npr_mid_per_unit":151.92,"npr_sell_per_unit":152.22},{"date":"2026-06-07","npr_buy_per_unit":151.62,"npr_mid_per_unit":151.92,"npr_sell_per_unit":152.22},{"date":"2026-06-08","npr_buy_per_unit":151.62,"npr_mid_per_unit":151.92,"npr_sell_per_unit":152.22}],"currency":"USD"},"meta":{"timestamp":"2026-06-10T13:59:07.991Z","request_id":"1a2dc192-bb60-4974-acfe-498e0be3e2d4"},"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 NRB mid 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.86412551,"amount":100,"result":86.412551,"source":"Nepal Rastra Bank","npr_per_to":176.56,"npr_per_from":152.57},"meta":{"timestamp":"2026-06-10T13:59:09.021Z","request_id":"ac9a7e0f-1937-4b29-9a7f-f8bb3cd25453"},"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/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"NRB list of quoted currencies","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":22,"source":"Nepal Rastra Bank","currencies":[{"name":"UAE Dirham","unit":1,"currency":"AED"},{"name":"Australian Dollar","unit":1,"currency":"AUD"},{"name":"Bahrain Dinar","unit":1,"currency":"BHD"},{"name":"Canadian Dollar","unit":1,"currency":"CAD"},{"name":"Swiss Franc","unit":1,"currency":"CHF"},{"name":"Chinese Yuan","unit":1,"currency":"CNY"},{"name":"Danish Kroner","unit":1,"currency":"DKK"},{"name":"European Euro","unit":1,"currency":"EUR"},{"name":"UK Pound Sterling","unit":1,"currency":"GBP"},{"name":"Hong Kong Dollar","unit":1,"currency":"HKD"},{"name":"Indian Rupee","unit":100,"currency":"INR"},{"name":"Japanese Yen","unit":10,"currency":"JPY"},{"name":"South Korean Won","unit":100,"currency":"KRW"},{"name":"Kuwaity Dinar","unit":1,"currency":"KWD"},{"name":"Malaysian Ringgit","unit":1,"currency":"MYR"},{"name":"Omani Rial","unit":1,"currency":"OMR"},{"name":"Qatari Riyal","unit":1,"currency":"QAR"},{"name":"Saudi Arabian Riyal","unit":1,"currency":"SAR"},{"name":"Swedish Kroner","unit":1,"currency":"SEK"},{"name":"Singapore Dollar","unit":1,"currency":"SGD"},{"name":"Thai Baht","unit":1,"currency":"THB"},{"name":"U.S. Dollar","unit":1,"currency":"USD"}]},"meta":{"timestamp":"2026-06-10T13:59:10.016Z","request_id":"63da8c89-e7e5-4369-bb2c-2de4f3c48851"},"status":"ok","message":"Currencies 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":{"date":"2026-06-10","source":"Nepal Rastra Bank Foreign Exchange Rate API (nrb.org.np, live)","service":"nrb-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's buy, sell, mid and inverse (currency=USD).","GET /v1/rates":"NRB official buy/sell for every currency vs the rupee (optional date=YYYY-MM-DD).","GET /v1/convert":"Convert an amount between two currencies at NRB mid rates (from=USD, to=EUR, amount=100).","GET /v1/history":"A currency's daily buy/sell rate over a date range (currency=USD, from=2026-06-01, to=2026-06-09).","GET /v1/currencies":"NRB list of quoted currencies."},"description":"Live official exchange-rate data for the Nepalese rupee (NPR) from Nepal Rastra Bank (NRB), the central bank of Nepal, via its public Foreign Exchange Rate API. The rates endpoint returns the NRB's official buy and sell rate for every published currency against the rupee for the latest (or any past) day, normalised to one unit; the rate endpoint returns a single currency's buy, sell and mid rate and the inverse; the history endpoint returns a currency's daily NRB buy/sell rate over a date range; the convert endpoint converts an amount between any two quoted currencies (including NPR) at the NRB's mid rate; the currencies endpoint returns the NRB's list of quoted currencies. Live, no key, nothing stored. Distinct from the ECB, BCRA, BCRP and other central-bank feeds and from market mid-rates — this is the NRB's own published rupee buy/sell rates (the NRB quotes both buy and sell, and some currencies per 100 units).","usd_npr_mid":152.57,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:11.017Z","request_id":"f0d3ee80-f521-414c-af0f-2a7a3811b3d1"},"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":500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":24000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":120000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5300,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nrb-api"}