Bank of Japan Exchange Rate API
Official Bank of Japan rates for 8 Sept 2026: 1 USD = 153.70 JPY. All 1 currency published, history back to 1998. Free JSON API for tax, audits, and compliant invoicing.
About Bank of Japan
The Bank of Japan publishes Tokyo-market USD/JPY reference rates each business day through its time-series statistics portal: the 17:00 JST spot rate and the central rate. These are the Bank's official record of the Tokyo interbank market, with history back to 1998.
- Official website: www.boj.or.jp/en
- Official rate publication: BOJ Time-Series Data Search — foreign exchange rates
Quick start
One request for the pair you need — USD to JPY at the official Bank of Japan rate:
curl "https://allratestoday.com/api/v1/central-bank/boj/latest?source=USD&target=JPY" \
-H "Authorization: Bearer art_live_your_key" Or the bank's full published table:
curl "https://allratestoday.com/api/v1/central-bank/boj/latest" \
-H "Authorization: Bearer art_live_your_key" On paid plans, any historical date or a time series:
curl "https://allratestoday.com/api/v1/central-bank/boj/history?source=USD&target=JPY&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Latest published rates (2026-09-08)
Below is the current table from Bank of Japan, unmodified — what a call to /latest returns right now, with values JPY per 1 unit of each currency:
Download this table: Excel (.xlsx) CSV (paid plan required)
One row per currency per publication date. Up to one year per download. Billed as one API call per currency per month of data.
Prefer a bulk file? The complete archive of every source is also published as an open dataset: central-bank-exchange-rates on Hugging Face
| Base | Quote | Type | Rate |
|---|---|---|---|
USD | JPY | middle | 153.7 |
USD | JPY | spot | 153.81 |
Node.js / TypeScript client
A dedicated zero-dependency npm package wraps these endpoints — boj-exchange-rate:
npm install boj-exchange-rate import { getRate } from 'boj-exchange-rate';
const pair = await getRate('USD', 'JPY', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.
Full reference — installation, all four functions, response shapes, error codes: boj-exchange-rate documentation.
Why use the official Bank of Japan rate?
When an auditor or tax office in Japan asks which rate you used, "the JPY mid-market rate at 14:32" is not an answer — the official rate published by Bank of Japan for that date is. This API returns exactly those published figures, stamped with the bank's own rate_date; on weekends and holidays the most recent published table is returned, as compliance rules expect.
If a pair isn't in the bank's published table, the API computes it from that table (inverse or cross via JPY) and marks it "derived": true — published and computed values are never silently mixed.
Endpoints
GET /api/v1/central-bank/boj/latest— latest table or single pair (all plans)GET /api/v1/central-bank/boj/{YYYY-MM-DD}— the table for any date (paid plans)GET /api/v1/central-bank/boj/history— time series, up to 5,000 rows (paid plans)GET /api/v1/central-bank/boj/availability— publication calendar: the dates the bank actually published (all plans)
Full parameter reference in the API documentation. Every request counts toward your plan's monthly quota — rates change once per business day, so caching a published table locally makes a small quota go far.
Frequently asked questions
Is there an API for Bank of Japan exchange rates?
Yes — this one. Official daily JPY rates as clean JSON, latest table on every plan including free.
How often does Bank of Japan update its rates?
New tables land once per business day — the API picks each one up shortly after Bank of Japan publishes it (latest: 2026-09-08).
Is this the official published table?
Yes — the rows are Bank of Japan's published figures, untouched, with the original publication date attached. Pairs the bank didn't print are computed and flagged derived.
Bank of Japan rates, one API key
Latest table on every plan. History back to 1998 on paid plans. No credit card to start.
Get Free API Key Read the Docs