{"openapi":"3.1.0","info":{"title":"Bank of Israel API","version":"1.0.0","description":"Live official exchange-rate data from the Bank of Israel (BOI), the central bank of Israel, for the new shekel (ILS) — each rate with the day's percentage change: the BOI official representative rate for every published currency (normalised to one unit), a single currency's shekel-per-unit rate and inverse plus daily change, the currencies ranked by daily change against the shekel (biggest gainers and losers), and currency conversion between any two published currencies (including ILS) cross-computed through the shekel.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/boi-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Signals"},{"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 shekel-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":"ILS","unit":1,"source":"Bank of Israel","currency":"USD","last_update":"2026-06-10","ils_per_unit":2.973,"unit_per_ils":0.33636058,"daily_change_pct":1.1913},"meta":{"timestamp":"2026-06-10T14:00:08.337Z","request_id":"ffb48b88-22c5-4968-9b21-ee4c51239dc3"},"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":"BOI official rate for every currency vs the shekel","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"ILS","date":"2026-06-10","count":14,"rates":[{"unit":1,"currency":"AUD","raw_rate":2.0848,"last_update":"2026-06-10","ils_per_unit":2.0848,"daily_change_pct":0.5498},{"unit":1,"currency":"CAD","raw_rate":2.1342,"last_update":"2026-06-10","ils_per_unit":2.1342,"daily_change_pct":1.1997},{"unit":1,"currency":"CHF","raw_rate":3.723,"last_update":"2026-06-10","ils_per_unit":3.723,"daily_change_pct":0.8397},{"unit":1,"currency":"DKK","raw_rate":0.4595,"last_update":"2026-06-10","ils_per_unit":0.4595,"daily_change_pct":1.0334},{"unit":1,"currency":"EGP","raw_rate":0.0573,"last_update":"2026-06-10","ils_per_unit":0.0573,"daily_change_pct":0.8803},{"unit":1,"currency":"EUR","raw_rate":3.4346,"last_update":"2026-06-10","ils_per_unit":3.4346,"daily_change_pct":1.0414},{"unit":1,"currency":"GBP","raw_rate":3.9814,"last_update":"2026-06-10","ils_per_unit":3.9814,"daily_change_pct":1.1406},{"unit":1,"currency":"JOD","raw_rate":4.1935,"last_update":"2026-06-10","ils_per_unit":4.1935,"daily_change_pct":1.2092},{"unit":100,"currency":"JPY","raw_rate":1.8528,"last_update":"2026-06-10","ils_per_unit":0.018528,"daily_change_pct":1.0141},{"unit":10,"currency":"LBP","raw_rate":0.0003,"last_update":"2026-06-10","ils_per_unit":3.0e-5,"daily_change_pct":0},{"unit":1,"currency":"NOK","raw_rate":0.3132,"last_update":"2026-06-10","ils_per_unit":0.3132,"daily_change_pct":0.7722},{"unit":1,"currency":"SEK","raw_rate":0.3132,"last_update":"2026-06-10","ils_per_unit":0.3132,"daily_change_pct":0.2882},{"unit":1,"currency":"USD","raw_rate":2.973,"last_update":"2026-06-10","ils_per_unit":2.973,"daily_change_pct":1.1913},{"unit":1,"currency":"ZAR","raw_rate":0.1795,"last_update":"2026-06-10","ils_per_unit":0.1795,"daily_change_pct":0.5039}],"source":"Bank of Israel"},"meta":{"timestamp":"2026-06-10T14:00:08.840Z","request_id":"0a2fd4e6-df5c-4388-8dd3-cd5676353732"},"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/movers":{"get":{"operationId":"get_v1_movers","tags":["Signals"],"summary":"Currencies ranked by daily change vs the shekel","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of gainers and losers each (1-13)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"ILS","date":"2026-06-10","note":"daily change of the currency against the shekel, in percent","losers":[{"currency":"LBP","ils_per_unit":3.0e-5,"daily_change_pct":0},{"currency":"SEK","ils_per_unit":0.3132,"daily_change_pct":0.2882},{"currency":"ZAR","ils_per_unit":0.1795,"daily_change_pct":0.5039},{"currency":"AUD","ils_per_unit":2.0848,"daily_change_pct":0.5498},{"currency":"NOK","ils_per_unit":0.3132,"daily_change_pct":0.7722}],"source":"Bank of Israel","gainers":[{"currency":"JOD","ils_per_unit":4.1935,"daily_change_pct":1.2092},{"currency":"CAD","ils_per_unit":2.1342,"daily_change_pct":1.1997},{"currency":"USD","ils_per_unit":2.973,"daily_change_pct":1.1913},{"currency":"GBP","ils_per_unit":3.9814,"daily_change_pct":1.1406},{"currency":"EUR","ils_per_unit":3.4346,"daily_change_pct":1.0414}]},"meta":{"timestamp":"2026-06-10T14:00:09.392Z","request_id":"8bd7bbfd-2c3b-4f0f-a050-3ded749c92e7"},"status":"ok","message":"Movers 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 BOI 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.86560298,"amount":100,"result":86.560298,"source":"Bank of Israel","ils_per_to":3.4346,"ils_per_from":2.973},"meta":{"timestamp":"2026-06-10T14:00:09.934Z","request_id":"b16048b1-d00a-494f-86b7-f5f74c18217e"},"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":"Bank of Israel public API (boi.org.il, live)","service":"boi-api","usd_ils":2.973,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, shekel-per-unit and inverse, plus daily change (currency=USD).","GET /v1/rates":"The BOI official rate for every currency vs the shekel, with daily change.","GET /v1/movers":"Currencies ranked by daily change vs the shekel — gainers and losers (limit=5).","GET /v1/convert":"Convert an amount between two currencies at BOI rates (from=USD, to=EUR, amount=100)."},"description":"Live official exchange-rate data from the Bank of Israel (BOI), the central bank of Israel, for the new shekel (ILS), via its public API — each rate with the day's percentage change. The rates endpoint returns the BOI's official representative rate for every published currency against the shekel, normalised to one unit; the rate endpoint returns a single currency's official rate (shekel-per-unit and the inverse) plus the daily change; the movers endpoint ranks currencies by their daily change against the shekel (biggest gainers and losers); the convert endpoint converts an amount between any two published currencies (including ILS) at the BOI's official rates, cross-computed through the shekel. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR and other central-bank feeds and from market mid-rates — this is the Bank of Israel's own official shekel representative rate with daily change and movers.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:00:10.456Z","request_id":"9a07e3cb-a745-481b-be55-f80b9714b9b9"},"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":13000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":169000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":1050000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4900,"monthly_call_quota":5600000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/boi-api"}