{"openapi":"3.1.0","info":{"title":"National Bank of Hungary FX API","version":"1.0.0","description":"Live official exchange-rate data from the National Bank of Hungary (Magyar Nemzeti Bank, MNB), the central bank of Hungary, for the forint (HUF) — straight from the MNB's own public SOAP web service, decoded for you as clean JSON. Get the MNB's official daily rate for every published currency against the forint, normalised to one unit; pull a single currency's forint-per-unit rate and its inverse; retrieve a currency's daily MNB rate over any date range from the bank's own time-series method; or convert an amount between any two published currencies (including HUF) cross-computed through the forint. Read live from the MNB, nothing cached. This is the official Hungarian-forint central-bank rate — distinct from the ECB, SNB, BNR, NBU, HNB, NBG, NBRB and other central-bank feeds and from market mid-rates: the Magyar Nemzeti Bank's own published forint rate.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mnb-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Rate"},{"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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"Official MNB rate for every currency vs the forint","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"HUF","date":"2026-06-10","count":32,"rates":[{"unit":1,"value":215.89,"currency":"AUD","huf_per_unit":215.89},{"unit":1,"value":59.54,"currency":"BRL","huf_per_unit":59.54},{"unit":1,"value":221.04,"currency":"CAD","huf_per_unit":221.04},{"unit":1,"value":385.51,"currency":"CHF","huf_per_unit":385.51},{"unit":1,"value":45.44,"currency":"CNY","huf_per_unit":45.44},{"unit":1,"value":14.72,"currency":"CZK","huf_per_unit":14.72},{"unit":1,"value":47.61,"currency":"DKK","huf_per_unit":47.61},{"unit":1,"value":355.84,"currency":"EUR","huf_per_unit":355.84},{"unit":1,"value":412.29,"currency":"GBP","huf_per_unit":412.29},{"unit":1,"value":39.3,"currency":"HKD","huf_per_unit":39.3},{"unit":100,"value":1.72,"currency":"IDR","huf_per_unit":0.0172},{"unit":1,"value":103.51,"currency":"ILS","huf_per_unit":103.51},{"unit":1,"value":3.23,"currency":"INR","huf_per_unit":3.23},{"unit":1,"value":2.48,"currency":"ISK","huf_per_unit":2.48},{"unit":100,"value":191.97,"currency":"JPY","huf_per_unit":1.9197},{"unit":100,"value":20.22,"currency":"KRW","huf_per_unit":0.2022},{"unit":1,"value":17.66,"currency":"MXN","huf_per_unit":17.66},{"unit":1,"value":75.77,"currency":"MYR","huf_per_unit":75.77},{"unit":1,"value":32.44,"currency":"NOK","huf_per_unit":32.44},{"unit":1,"value":178.97,"currency":"NZD","huf_per_unit":178.97},{"unit":1,"value":5.02,"currency":"PHP","huf_per_unit":5.02},{"unit":1,"value":83.76,"currency":"PLN","huf_per_unit":83.76},{"unit":1,"value":67.92,"currency":"RON","huf_per_unit":67.92},{"unit":1,"value":3.03,"currency":"RSD","huf_per_unit":3.03},{"unit":1,"value":4.28,"currency":"RUB","huf_per_unit":4.28},{"unit":1,"value":32.47,"currency":"SEK","huf_per_unit":32.47},{"unit":1,"value":239.15,"currency":"SGD","huf_per_unit":239.15},{"unit":1,"value":9.36,"currency":"THB","huf_per_unit":9.36},{"unit":1,"value":6.68,"currency":"TRY","huf_per_unit":6.68},{"unit":1,"value":6.85,"currency":"UAH","huf_per_unit":6.85},{"unit":1,"value":307.98,"currency":"USD","huf_per_unit":307.98},{"unit":1,"value":18.61,"currency":"ZAR","huf_per_unit":18.61}],"source":"Magyar Nemzeti Bank"},"meta":{"timestamp":"2026-06-10T13:59:43.966Z","request_id":"4d7d3e80-13fa-4931-b637-2f64e39d6908"},"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 official forint rate 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":"HUF","date":"2026-06-10","unit":1,"source":"Magyar Nemzeti Bank","currency":"USD","huf_per_unit":307.98,"unit_per_huf":0.00324696},"meta":{"timestamp":"2026-06-10T13:59:44.153Z","request_id":"f59d1b98-5c91-4354-b199-d2ac7f6c292b"},"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 MNB 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":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-31"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-05-31","base":"HUF","from":"2026-05-01","count":19,"source":"Magyar Nemzeti Bank","history":[{"date":"2026-05-04","unit":1,"huf_per_unit":309.77},{"date":"2026-05-05","unit":1,"huf_per_unit":311.28},{"date":"2026-05-06","unit":1,"huf_per_unit":305.55},{"date":"2026-05-07","unit":1,"huf_per_unit":303},{"date":"2026-05-08","unit":1,"huf_per_unit":301.89},{"date":"2026-05-11","unit":1,"huf_per_unit":301.71},{"date":"2026-05-12","unit":1,"huf_per_unit":303.7},{"date":"2026-05-13","unit":1,"huf_per_unit":306.96},{"date":"2026-05-14","unit":1,"huf_per_unit":305.67},{"date":"2026-05-15","unit":1,"huf_per_unit":309.23},{"date":"2026-05-18","unit":1,"huf_per_unit":309.57},{"date":"2026-05-19","unit":1,"huf_per_unit":310.28},{"date":"2026-05-20","unit":1,"huf_per_unit":311.77},{"date":"2026-05-21","unit":1,"huf_per_unit":308.96},{"date":"2026-05-22","unit":1,"huf_per_unit":309.41},{"date":"2026-05-26","unit":1,"huf_per_unit":306.63},{"date":"2026-05-27","unit":1,"huf_per_unit":304.98},{"date":"2026-05-28","unit":1,"huf_per_unit":305.98},{"date":"2026-05-29","unit":1,"huf_per_unit":304.86}],"currency":"USD"},"meta":{"timestamp":"2026-06-10T13:59:44.299Z","request_id":"94dadd48-9b98-4511-8be6-31f16ac961cd"},"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 MNB 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.86550135,"amount":100,"result":86.550135,"source":"Magyar Nemzeti Bank","huf_per_to":355.84,"huf_per_from":307.98},"meta":{"timestamp":"2026-06-10T13:59:44.449Z","request_id":"5f8fdc1b-0401-4008-9d09-941a32159cea"},"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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-10","source":"MNB SOAP web service arfolyamok.asmx (mnb.hu, live)","service":"mnb-api","usd_huf":307.98,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, forint-per-unit and inverse (currency=USD).","GET /v1/rates":"The MNB official daily rate for every currency vs the forint.","GET /v1/convert":"Convert an amount between two currencies at MNB rates (from=USD, to=EUR, amount=100).","GET /v1/history":"A currency's daily MNB rate over a date range (currency=USD, from=2026-05-01, to=2026-05-31)."},"description":"Live official exchange-rate data from the National Bank of Hungary (Magyar Nemzeti Bank, MNB), the central bank of Hungary, for the forint (HUF), via the MNB's public SOAP web service. The rates endpoint returns the MNB's official daily rate for every published currency against the forint, normalised to one unit; the rate endpoint returns a single currency's forint-per-unit rate and the inverse; the history endpoint returns a currency's daily MNB rate over a date range from the MNB's own time-series method; the convert endpoint converts an amount between any two published currencies (including HUF) at the MNB's official rates, cross-computed through the forint. Live, no key, nothing stored. Distinct from the ECB, SNB, BNR, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK, BNM, NBT and other central-bank feeds and from market mid-rates — this is the Magyar Nemzeti Bank's own official forint rate, delivered over SOAP.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:44.590Z","request_id":"9e804f62-cf27-40de-9e68-9b4ae8294dac"},"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":850,"monthly_call_quota":25000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2550,"monthly_call_quota":125000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6100,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mnb-api"}