# Boj — Zapi reference > Japan's monetary base and its components. **Base URL:** `https://api.zpi.web.id` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys. **Response envelope:** `{ content, message, errors }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zpi.web.id/api/finance/boj - Endpoint catalog: https://zpi.web.id/category/finance - Concise index: https://zpi.web.id/llms.txt - Full reference: https://zpi.web.id/llms-full.txt --- ## Boj **Category:** finance · **Slug:** `boj` **Detail page:** https://zpi.web.id/api/finance/boj Japan's monetary base and its components. **Tags:** finance, boj ### Monetary Base Japan's monetary base and its components. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:boj/monetary-base` - **Cache TTL:** 21600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `lang` | enum(en|ja) | query | no | Language of the series names and units. Default en. | | `from` | string | query | no | Earliest month, YYYY-MM. | | `to` | string | query | no | Latest month, YYYY-MM. | | `length` | number | query | no | Observations per series, newest first. Default 60, max 20000. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:boj/monetary-base?lang=en&from=2025-01&to=2026-07&length=24" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:boj/monetary-base?lang=en&from=2025-01&to=2026-07&length=24", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:boj/monetary-base?lang=en&from=2025-01&to=2026-07&length=24", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "to": null, "from": null, "lang": "en", "count": 8, "items": [ { "end": "2026-07", "code": "MD01'MABS1AN11@", "name": "Monetary Base/Average Amounts Outstanding/Year-on-year change", "unit": "%", "count": 60, "start": "1971-01", "total": 559, "values": [ { "value": -13.8, "period": "2026-07" }, { "value": -13.7, "period": "2026-06" }, { "value": -12.2, "period": "2026-05" }, { "value": -11.3, "period": "2026-04" }, { "value": -11.6, "period": "2026-03" }, { "value": -10.6, "period": "2026-02" }, { "value": -9.5, "period": "2026-01" }, { "value": -9.8, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": -13.8, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS2AN116@", "name": "Monetary Base/Banknotes in Circulation/Average Amounts Outstanding/Year-on-year change", "unit": "%", "count": 60, "start": "1971-01", "total": 559, "values": [ { "value": -1.9, "period": "2026-07" }, { "value": -1.8, "period": "2026-06" }, { "value": -1.7, "period": "2026-05" }, { "value": -1.8, "period": "2026-04" }, { "value": -1.9, "period": "2026-03" }, { "value": -2.2, "period": "2026-02" }, { "value": -2.8, "period": "2026-01" }, { "value": -2.7, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": -1.9, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS2AN117@", "name": "Monetary Base/Coins in Circulation/Average Amounts Outstanding/Year-on-year change", "unit": "%", "count": 60, "start": "1971-01", "total": 559, "values": [ { "value": -1.1, "period": "2026-07" }, { "value": -1.1, "period": "2026-06" }, { "value": -1.1, "period": "2026-05" }, { "value": -1.1, "period": "2026-04" }, { "value": -1.2, "period": "2026-03" }, { "value": -1.2, "period": "2026-02" }, { "value": -1.3, "period": "2026-01" }, { "value": -1.3, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": -1.1, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS1AN113@", "name": "Monetary Base/Current Account Balances/Average Amounts Outstanding/Year-on-year change", "unit": "%", "count": 60, "start": "1982-04", "total": 559, "values": [ { "value": -16.6, "period": "2026-07" }, { "value": -16.4, "period": "2026-06" }, { "value": -14.7, "period": "2026-05" }, { "value": -13.5, "period": "2026-04" }, { "value": -13.9, "period": "2026-03" }, { "value": -12.6, "period": "2026-02" }, { "value": -11.1, "period": "2026-01" }, { "value": -11.5, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": -16.6, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS1AN11", "name": "Monetary Base/Average Amounts Outstanding", "unit": "100 million yen", "count": 60, "start": "1970-01", "total": 559, "values": [ { "value": 5549259, "period": "2026-07" }, { "value": 5592039, "period": "2026-06" }, { "value": 5757634, "period": "2026-05" }, { "value": 5829256, "period": "2026-04" }, { "value": 5707875, "period": "2026-03" }, { "value": 5809326, "period": "2026-02" }, { "value": 5894035, "period": "2026-01" }, { "value": 5941943, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": 5549259, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS2AN116", "name": "Monetary Base/Banknotes in Circulation/Average Amounts Outstanding", "unit": "100 million yen", "count": 60, "start": "1970-01", "total": 559, "values": [ { "value": 1150060, "period": "2026-07" }, { "value": 1148870, "period": "2026-06" }, { "value": 1158979, "period": "2026-05" }, { "value": 1161152, "period": "2026-04" }, { "value": 1166535, "period": "2026-03" }, { "value": 1170075, "period": "2026-02" }, { "value": 1186847, "period": "2026-01" }, { "value": 1187041, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": 1150060, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS2AN117", "name": "Monetary Base/Coins in Circulation/Average Amounts Outstanding", "unit": "100 million yen", "count": 60, "start": "1970-01", "total": 559, "values": [ { "value": 45831, "period": "2026-07" }, { "value": 45933, "period": "2026-06" }, { "value": 46035, "period": "2026-05" }, { "value": 46063, "period": "2026-04" }, { "value": 46127, "period": "2026-03" }, { "value": 46234, "period": "2026-02" }, { "value": 46327, "period": "2026-01" }, { "value": 46287, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": 45831, "latestPeriod": "2026-07" }, { "end": "2026-07", "code": "MD01'MABS1AN113", "name": "Monetary Base/Current Account Balances/Average Amounts Outstanding", "unit": "100 million yen", "count": 60, "start": "1981-04", "total": 559, "values": [ { "value": 4353368, "period": "2026-07" }, { "value": 4397236, "period": "2026-06" }, { "value": 4552620, "period": "2026-05" }, { "value": 4622041, "period": "2026-04" }, { "value": 4495213, "period": "2026-03" }, { "value": 4593017, "period": "2026-02" }, { "value": 4660861, "period": "2026-01" }, { "value": 4708615, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": 4353368, "latestPeriod": "2026-07" } ], "table": "md01_m_1", "title": "Monetary Base/Average Amounts Outstanding (Monthly)", "total": 4472, "dataset": "monetary-base", "provider": "boj", "snapshotAt": "2026-08-21 AM 09:00" } ``` --- ### Table One of the Bank of Japan's pre-built time-series tables. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:boj/table` - **Cache TTL:** 21600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `table` | string | query | yes | Table id. The 28 published ids come from `tables` — ir01_d_1, ir01_m_1, fm01_d_1, md01_m_1, bs02_m_1, ff_q_1, co_q_1 and so on. | | `lang` | enum(en|ja) | query | no | Language of the series names and units. Default en. | | `from` | string | query | no | Earliest period, YYYY, YYYY-MM or YYYY-MM-DD to match the table's own frequency. | | `to` | string | query | no | Latest period, same format as `from`. | | `length` | number | query | no | Observations per series, newest first. Default 120, max 20000. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:boj/table?table=ir01_m_1&lang=en&from=2020-01&to=2026-07&length=60" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:boj/table?table=ir01_m_1&lang=en&from=2020-01&to=2026-07&length=60", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:boj/table?table=ir01_m_1&lang=en&from=2020-01&to=2026-07&length=60", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "to": null, "from": null, "lang": "en", "count": 1, "items": [ { "end": "2026-07", "code": "IR01'MADR1M", "name": "The Basic Discount Rate and Basic Loan Rate", "unit": "Percent per annum", "count": 120, "start": "1882-10", "total": 559, "values": [ { "value": 1.25, "period": "2026-07" }, { "value": 1.25, "period": "2026-06" }, { "value": 1, "period": "2026-05" }, { "value": 1, "period": "2026-04" }, { "value": 1, "period": "2026-03" }, { "value": 1, "period": "2026-02" }, { "value": 1, "period": "2026-01" }, { "value": 1, "period": "2025-12" } ], "lastUpdate": "2026-08-04", "latestValue": 1.25, "latestPeriod": "2026-07" } ], "table": "ir01_m_1", "title": "Basic Loan Rate (Monthly)", "total": 559, "dataset": "table", "provider": "boj", "snapshotAt": "2026-08-21 AM 09:00" } ``` --- ### Rates The Bank of Japan's policy and money-market rates. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:boj/rates` - **Cache TTL:** 21600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `frequency` | enum(daily|monthly) | query | no | daily reads ir01_d_1 and fm01_d_1, monthly reads ir01_m_1 and fm02_m_1. Default daily. | | `lang` | enum(en|ja) | query | no | Language of the series names and units. Default en. | | `from` | string | query | no | Earliest period, YYYY-MM-DD for daily or YYYY-MM for monthly. | | `to` | string | query | no | Latest period, same format as `from`. | | `length` | number | query | no | Observations per series, newest first. Default 60, max 20000. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:boj/rates?frequency=daily&lang=en&from=2026-01&to=2026-08-18&length=30" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:boj/rates?frequency=daily&lang=en&from=2026-01&to=2026-08-18&length=30", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:boj/rates?frequency=daily&lang=en&from=2026-01&to=2026-08-18&length=30", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "to": null, "from": null, "lang": "en", "count": 2, "items": [ { "end": "2026-08-19", "code": "IR01'MADR1Z@D", "name": "The Basic Discount Rate and Basic Loan Rate", "unit": "Percent per annum", "count": 60, "start": "1882-10-11", "table": "ir01_d_1", "total": 10458, "values": [ { "value": 1.25, "period": "2026-08-19" }, { "value": 1.25, "period": "2026-08-18" }, { "value": 1.25, "period": "2026-08-17" }, { "value": 1.25, "period": "2026-08-16" }, { "value": 1.25, "period": "2026-08-15" }, { "value": 1.25, "period": "2026-08-14" }, { "value": 1.25, "period": "2026-08-13" }, { "value": 1.25, "period": "2026-08-12" } ], "lastUpdate": "2026-08-21", "latestValue": 1.25, "latestPeriod": "2026-08-19" }, { "end": "2026-08-19", "code": "FM01'STRDCLUCON", "name": "Call Rate, Uncollateralized Overnight, Average (Daily)", "unit": "percent per annum", "count": 60, "start": "1998-01-05", "table": "fm01_d_1", "total": 10454, "values": [ { "value": 0.977, "period": "2026-08-19" }, { "value": 0.977, "period": "2026-08-18" }, { "value": 0.977, "period": "2026-08-17" }, { "value": null, "period": "2026-08-16" }, { "value": null, "period": "2026-08-15" }, { "value": 0.977, "period": "2026-08-14" }, { "value": 0.977, "period": "2026-08-13" }, { "value": 0.977, "period": "2026-08-12" } ], "lastUpdate": "2026-08-21", "latestValue": 0.977, "latestPeriod": "2026-08-19" } ], "total": 20912, "tables": [ "ir01_d_1", "fm01_d_1" ], "dataset": "rates", "provider": "boj", "frequency": "daily", "snapshotAt": "2026-08-21 AM 09:00" } ``` --- ### Tables The Bank of Japan's 28 pre-built time-series tables, with the frequency and - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:boj/tables` - **Cache TTL:** 86400s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `lang` | enum(en|ja) | query | no | Language of the table and category names. Default en. | | `query` | string | query | no | Case-insensitive filter over the table id, name and category. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:boj/tables?lang=en&query=rates" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:boj/tables?lang=en&query=rates", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:boj/tables?lang=en&query=rates", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "lang": "en", "count": 28, "items": [ { "name": "Basic Loan Rate", "table": "ir01_d_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/ir01_d_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/ir01_d_1_en.html", "category": "Interest Rates on Deposits and Loans", "frequency": "daily", "frequencyLabel": "Daily" }, { "name": "Basic Loan Rate", "table": "ir01_m_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/ir01_m_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/ir01_m_1_en.html", "category": "Interest Rates on Deposits and Loans", "frequency": "monthly", "frequencyLabel": "Monthly" }, { "name": "Average Interest Rates Posted at Financial Institutions by Type of Deposit", "table": "ir02_m_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/ir02_m_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/ir02_m_1_en.html", "category": "Interest Rates on Deposits and Loans", "frequency": "monthly", "frequencyLabel": "Monthly" }, { "name": "Average Contracted Interest Rates on Loans and Discounts", "table": "ir04_m_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/ir04_m_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/ir04_m_1_en.html", "category": "Interest Rates on Deposits and Loans", "frequency": "monthly", "frequencyLabel": "Monthly" }, { "name": "Call Rates", "table": "fm01_d_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/fm01_d_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/fm01_d_1_en.html", "category": "Financial Markets", "frequency": "daily", "frequencyLabel": "Daily" }, { "name": "Call Rates", "table": "fm02_m_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/fm02_m_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/fm02_m_1_en.html", "category": "Financial Markets", "frequency": "monthly", "frequencyLabel": "Monthly" }, { "name": "Foreign Exchange Rate(Tokyo Market Interbank Rates)", "table": "fm08_d_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/fm08_d_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/fm08_d_1_en.html", "category": "Financial Markets", "frequency": "daily", "frequencyLabel": "Daily" }, { "name": "Foreign Exchange Rate(Tokyo Market Interbank Rates)", "table": "fm08_m_1", "csvUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/csv/fm08_m_1_en.csv", "pageUrl": "https://www.stat-search.boj.or.jp/ssi/mtshtml/fm08_m_1_en.html", "category": "Financial Markets", "frequency": "monthly", "frequencyLabel": "Monthly" } ], "query": null, "total": 28, "dataset": "tables", "provider": "boj" } ``` --- _Generated: 2026-08-21T07:39:38.567Z_