Bank of Japan Exchange Rate API

Official Bank of Japan (Japan) daily exchange rates as JSON: 1 currencies, history back to 1998. The published JPY rates required for tax, audits, and compliant invoicing.

Bank of Japan official daily exchange rates as JSON: 1 currencies against the JPY, history back to 1998. Latest table on every plan. Get your API key.

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 daily 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-08-03)

The most recent table as published by Bank of Japan — exactly what the /latest endpoint returns right now. Values are JPY per 1 unit of each currency:

Base	Quote	Type	Rate
USD	JPY	middle	156.5
USD	JPY	spot	156.77

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.

Why use the official Bank of Japan rate?

Live market rates move continuously, but tax filings, customs declarations, audits, and statutory accounting in Japan and beyond typically require the official rate published by Bank of Japan for a given date — a fixed, citable number that never changes after publication. This API serves those published tables with the bank's own rate_date on every response; weekends and holidays return the most recent published date, which is the rate compliance rules require you to apply.

Pairs the bank doesn't print directly are resolved from its table (inverse or cross via JPY) and explicitly flagged "derived": true — so what the bank printed and what was computed are never confused.

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 — daily 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 day's 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 are the rates updated?

Bank of Japan publishes once per business day; the API ingests each new table shortly after publication (latest: 2026-08-03).

Are these the official rates?

Yes — ingested from Bank of Japan's own published data, served unmodified with the bank's publication date. Anything computed rather than published is flagged derived.

Other central banks

All covered central banksCoverage, endpoints, and plans US Federal Reserve (H.10)United States — official USD rates Bank of EnglandUnited Kingdom — official GBP rates People's Bank of China (CFETS)China — official CNY rates Reserve Bank of AustraliaAustralia — official AUD rates Bank of RussiaRussia — official RUB rates Central Bank of TürkiyeTürkiye — official TRY rates Banco Central do Brasil (PTAX)Brazil — official BRL rates Bank IndonesiaIndonesia — official IDR rates Reserve Bank of IndiaIndia — official INR rates Bank of CanadaCanada — official CAD rates Bank Negara MalaysiaMalaysia — official MYR rates Central Bank of Sri LankaSri Lanka — official LKR rates Czech National BankCzech Republic — official CZK rates European Central BankEurozone — official EUR rates Narodowy Bank PolskiPoland — official PLN rates Norges BankNorway — official NOK rates Sveriges RiksbankSweden — official SEK rates Central Bank of NigeriaNigeria — official NGN rates Central Bank of KuwaitKuwait — official KWD rates Central Bank of BahrainBahrain — official BHD rates Central Bank of AzerbaijanAzerbaijan — official AZN rates Central Bank of Bosnia and HerzegovinaBosnia and Herzegovina — official BAM rates Bulgarian National BankBulgaria — official EUR rates Central Reserve Bank of PeruPeru — official PEN rates Hong Kong Monetary AuthorityHong Kong — official HKD rates Bank of IsraelIsrael — official ILS rates Central Bank of ArgentinaArgentina — official ARS rates South African Reserve BankSouth Africa — official ZAR rates Swiss National BankSwitzerland — official CHF rates Reserve Bank of New ZealandNew Zealand — official NZD rates