{"openapi":"3.1.0","info":{"title":"Bank Negara Malaysia FX & Rates API","version":"1.0.0","description":"Official central-bank data from Bank Negara Malaysia (BNM), the central bank of Malaysia, all quoted around the Malaysian Ringgit (MYR). Read every BNM foreign-exchange reference rate with its buying, selling and middle quote — each row carries the BNM quoting unit (the Japanese Yen, for example, is quoted per 100) plus a normalized myr_per_unit, so conversions are never ambiguous — look up a single currency, or convert any amount between two quoted currencies or MYR using the central-bank cross rate. Beyond FX, the same surface exposes the Kijang Emas gold bullion coin buying and selling prices (one, half and quarter ounce), the current Overnight Policy Rate set by the Monetary Policy Committee, and the published base rate, base lending rate and indicative effective lending rate for every licensed Malaysian bank. Rates always resolve to the latest published business-day fixing. Distinct from our other central-bank FX feeds: this bundles Malaysian FX, gold and policy/lending rates in one API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/malaysia-fx-api","description":"oanor gateway"}],"tags":[{"name":"FX"},{"name":"Convert"},{"name":"Gold"},{"name":"Rates"},{"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/exchange-rates":{"get":{"operationId":"get_v1_exchange_rates","tags":["FX"],"summary":"All BNM FX reference rates","description":"","parameters":[{"name":"symbols","in":"query","required":false,"description":"Comma-separated currency codes to filter (omit for all)","schema":{"type":"string"},"example":"USD,EUR,SGD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"MYR","date":"2026-06-15","count":3,"rates":[{"base":"MYR","date":"2026-06-15","unit":1,"currency":"EUR","buying_rate":4.6953,"middle_rate":4.699,"myr_per_unit":4.699,"selling_rate":4.7027},{"base":"MYR","date":"2026-06-15","unit":1,"currency":"SGD","buying_rate":3.1578,"middle_rate":3.1604,"myr_per_unit":3.1604,"selling_rate":3.1629},{"base":"MYR","date":"2026-06-15","unit":1,"currency":"USD","buying_rate":4.048,"middle_rate":4.0505,"myr_per_unit":4.0505,"selling_rate":4.053}]},"meta":{"timestamp":"2026-06-15T11:15:25.988Z","request_id":"8075ce73-bcb5-4e09-8696-f7f1234da7d2"},"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":["FX"],"summary":"Reference rate for one currency","description":"","parameters":[{"name":"code","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":"MYR","date":"2026-06-15","unit":1,"currency":"USD","buying_rate":4.048,"middle_rate":4.0505,"myr_per_unit":4.0505,"selling_rate":4.053},"meta":{"timestamp":"2026-06-15T11:15:26.081Z","request_id":"a39ebead-5b03-4b53-8cb6-aba1cb394c95"},"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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert between currencies via the BNM cross rate","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency (or MYR)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency (or MYR)","schema":{"type":"string"},"example":"MYR"},{"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":"MYR","base":"MYR","from":"USD","rate":4.0505,"amount":100,"result":405.05},"meta":{"timestamp":"2026-06-15T11:15:26.147Z","request_id":"02318974-0e1c-4e26-9970-f892e3dcaaa2"},"status":"ok","message":"Conversion computed 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/gold":{"get":{"operationId":"get_v1_gold","tags":["Gold"],"summary":"Kijang Emas gold bullion prices","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"one_oz":{"buying":17701,"selling":18436},"half_oz":{"buying":8850,"selling":9392},"currency":"MYR","instrument":"Kijang Emas (Malaysian gold bullion coin)","quarter_oz":{"buying":4425,"selling":4783},"effective_date":"2026-06-15"},"meta":{"timestamp":"2026-06-15T11:15:26.475Z","request_id":"1d9a951f-dd0c-4fa8-9064-054a6c2d613f"},"status":"ok","message":"Gold prices 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/base-rates":{"get":{"operationId":"get_v1_base_rates","tags":["Rates"],"summary":"Per-bank base and lending rates","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"banks":[{"bank_code":"AFFINBANK","bank_name":"Affin Bank","base_rate":2.7,"base_lending_rate":5.56,"indicative_eff_lending_rate":3.3},{"bank_code":"ALLIANCEB","bank_name":"Alliance Bank","base_rate":2.57,"base_lending_rate":5.42,"indicative_eff_lending_rate":3.11},{"bank_code":"AMBANK","bank_name":"AmBank","base_rate":2.6,"base_lending_rate":5.45,"indicative_eff_lending_rate":3.25},{"bank_code":"BANGKOK","bank_name":"Bangkok Bank Berhad","base_rate":3.22,"base_lending_rate":5.87,"indicative_eff_lending_rate":4.42},{"bank_code":"BANKCHINA","bank_name":"Bank of China (Malaysia) Berhad","base_rate":2.55,"base_lending_rate":5.35,"indicative_eff_lending_rate":3.55},{"bank_code":"CIMB BANK","bank_name":"CIMB Bank Berhad","base_rate":2.75,"base_lending_rate":5.6,"indicative_eff_lending_rate":3.5},{"bank_code":"CITIBANK","bank_name":"Citibank Berhad","base_rate":2.4,"base_lending_rate":5.55,"indicative_eff_lending_rate":3.2},{"bank_code":"","bank_name":"Hong Leong Bank Malaysia Berhad","base_rate":2.63,"base_lending_rate":5.64,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"HSBC Bank Malaysia Berhad","base_rate":2.39,"base_lending_rate":5.49,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"Industrial and Commercial Bank of China (Malaysia) Berhad","base_rate":2.52,"base_lending_rate":5.45,"indicative_eff_lending_rate":3.47},{"bank_code":"","bank_name":"Malayan Banking Berhad","base_rate":1.75,"base_lending_rate":5.4,"indicative_eff_lending_rate":3.25},{"bank_code":"","bank_name":"OCBC Bank (Malaysia) Berhad","base_rate":2.58,"base_lending_rate":5.51,"indicative_eff_lending_rate":3.45},{"bank_code":"","bank_name":"Public Bank Berhad","base_rate":2.27,"base_lending_rate":5.47,"indicative_eff_lending_rate":3.1},{"bank_code":"","bank_name":"RHB Bank Berhad","base_rate":2.5,"base_lending_rate":5.45,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"Standard Chartered Bank Malaysia Berhad","base_rate":2.27,"base_lending_rate":5.45,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"United Overseas Bank (Malaysia) Bhd.","base_rate":2.61,"base_lending_rate":5.57,"indicative_eff_lending_rate":3.36},{"bank_code":"AFFINIB","bank_name":"Affin Islamic Bank Berhad","base_rate":2.7,"indicative_eff_lending_rate":3.3},{"bank_code":"RJHI","bank_name":"Al Rajhi Banking & Investment Corporation (Malaysia) Berhad","base_rate":2.85,"indicative_eff_lending_rate":4.2},{"bank_code":"","bank_name":"Alliance Islamic Bank Berhad","base_rate":2.57,"indicative_eff_lending_rate":3.11},{"bank_code":"","bank_name":"AmBank Islamic Berhad","base_rate":2.6,"indicative_eff_lending_rate":3.25},{"bank_code":"","bank_name":"Bank Islam Malaysia Berhad","base_rate":2.52,"indicative_eff_lending_rate":3.25},{"bank_code":"","bank_name":"Bank Muamalat Malaysia Berhad","base_rate":2.56,"indicative_eff_lending_rate":3.56},{"bank_code":"","bank_name":"CIMB Islamic Bank Berhad","base_rate":2.75,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"Hong Leong Islamic Bank Berhad","base_rate":2.63,"indicative_eff_lending_rate":3.35},{"bank_code":"","bank_name":"HSBC Amanah Malaysia Berhad","base_rate":2.39,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"Kuwait Finance House (Malaysia) Berhad","base_rate":2.25,"indicative_eff_lending_rate":3.3},{"bank_code":"","bank_name":"Maybank Islamic Berhad","base_rate":1.75,"indicative_eff_lending_rate":3.25},{"bank_code":"","bank_name":"MBSB Bank Berhad","base_rate":2.65,"indicative_eff_lending_rate":3.2},{"bank_code":"","bank_name":"OCBC Al-Amin Bank Berhad","base_rate":2.58,"indicative_eff_lending_rate":3.45},{"bank_code":"","bank_name":"Public Islamic Bank Berhad","base_rate":2.27,"indicative_eff_lending_rate":3.1},{"bank_code":"","bank_name":"RHB Islamic Bank Berhad","base_rate":2.5,"indicative_eff_lending_rate":3.5},{"bank_code":"","bank_name":"Standard Chartered Saadiq Berhad","base_rate":2.27,"indicative_eff_lending_rate":3.5},{"bank_code":"BKRMB","bank_name":"Bank Kerjasama Rakyat Malaysia Berhad","base_rate":2.6,"indicative_eff_lending_rate":3.4},{"bank_code":"","bank_name":"Agrobank","base_rate":2.35,"indicative_eff_lending_rate":0},{"bank_code":"","bank_name":"Bank Simpanan Nasional","base_rate":2.6,"indicative_eff_lending_rate":3.1}],"count":35},"meta":{"timestamp":"2026-06-15T11:15:26.772Z","request_id":"ada02dc8-84c2-4ba5-b3fa-c02972a3e78d"},"status":"ok","message":"Base 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/opr":{"get":{"operationId":"get_v1_opr","tags":["Rates"],"summary":"Current Overnight Policy Rate","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-05-07","year":2026,"indicator":"Overnight Policy Rate (OPR)","change_in_opr":0,"new_opr_level_percent":2.75},"meta":{"timestamp":"2026-06-15T11:15:27.096Z","request_id":"a5102725-9a93-4b1b-8918-d9d9306bac24"},"status":"ok","message":"Policy 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Bank Negara Malaysia FX & Rates API","source":"Bank Negara Malaysia Open API (api.bnm.gov.my)","endpoints":[{"path":"/v1/exchange-rates","description":"All BNM FX reference rates (optional ?symbols=USD,EUR)"},{"path":"/v1/rate","description":"Reference rate for one currency (?code=USD)"},{"path":"/v1/convert","description":"Convert between currencies or MYR (?from=USD&to=MYR&amount=100)"},{"path":"/v1/gold","description":"Kijang Emas gold bullion buying/selling prices"},{"path":"/v1/opr","description":"Current Overnight Policy Rate"},{"path":"/v1/base-rates","description":"Per-bank base and lending rates"},{"path":"/v1/meta","description":"This metadata document"}],"disclaimer":"Unofficial proxy of the public Bank Negara Malaysia Open API. Not affiliated with BNM. Reference data only.","description":"Official foreign-exchange reference rates (base MYR), Kijang Emas gold bullion prices, the Overnight Policy Rate and per-bank base lending rates, published by Bank Negara Malaysia (the central bank of Malaysia).","base_currency":"MYR","quantity_note":"Each FX row carries the BNM quoting unit (e.g. JPY is quoted per 100) plus a normalized myr_per_unit so conversions are unambiguous."},"meta":{"timestamp":"2026-06-15T11:15:27.192Z","request_id":"ef14c836-6523-4252-80f2-5cf54c6678b4"},"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":1620,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1180,"monthly_call_quota":49600,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3540,"monthly_call_quota":214000,"rps_limit":18,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":7960,"monthly_call_quota":912000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/malaysia-fx-api"}