Monetary Base
GET
/v1/finance:boj/monetary-basepassing · 0.4s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| lang | enum | query | Language of the series names and units. Default en. One of en, ja. |
| from | string | query | Earliest month, YYYY-MM. |
| to | string | query | Latest month, YYYY-MM. |
| length | number | query | Observations per series, newest first. Default 60, max 20000. |
Example response
{"project":"finance:boj", "data": {"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" } ],"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" } ],"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" } ],"lastUpdate":"2026-08-04","latestValue":-1.1,"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" },"timestamp":"2026-08-21T02:22:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Table
One of the Bank of Japan's pre-built time-series tables.
GET
/v1/finance:boj/tablepassing · 0.2s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| table | string | query | 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. Required. |
| lang | enum | query | Language of the series names and units. Default en. One of en, ja. |
| from | string | query | Earliest period, YYYY, YYYY-MM or YYYY-MM-DD to match the table's own frequency. |
| to | string | query | Latest period, same format as `from`. |
| length | number | query | Observations per series, newest first. Default 120, max 20000. |
Example response
{"project":"finance:boj", "data": {"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" },"timestamp":"2026-08-21T02:22:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Rates
The Bank of Japan's policy and money-market rates.
GET
/v1/finance:boj/ratespassing · 0.4s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| frequency | enum | query | daily reads ir01_d_1 and fm01_d_1, monthly reads ir01_m_1 and fm02_m_1. Default daily. One of daily, monthly. |
| lang | enum | query | Language of the series names and units. Default en. One of en, ja. |
| from | string | query | Earliest period, YYYY-MM-DD for daily or YYYY-MM for monthly. |
| to | string | query | Latest period, same format as `from`. |
| length | number | query | Observations per series, newest first. Default 60, max 20000. |
Example response
{"project":"finance:boj", "data": {"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" },"timestamp":"2026-08-21T02:22:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Tables
The Bank of Japan's 28 pre-built time-series tables, with the frequency and
GET
/v1/finance:boj/tablespassing · 0.3s1d cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| lang | enum | query | Language of the table and category names. Default en. One of en, ja. |
| query | string | query | Case-insensitive filter over the table id, name and category. |
Example response
{"project":"finance:boj", "data": {"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" },"timestamp":"2026-08-21T02:22:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:boj", "monetary-base", { lang: "en", from: "2025-01", to: "2026-07", length: 24 });
Boj
Japan's monetary base and its components.
4 endpoints409 calls4/4 passing
GET
/v1/…boj/monetary-basepassing · 0.4s6h cache
Try it
Parameters
lang
enum · query · optional
Language of the series names and units. Default en.
from
string · query · optional
Earliest month, YYYY-MM.
to
string · query · optional
Latest month, YYYY-MM.
length
number · query · optional
Observations per series, newest first. Default 60, max 20000.
Example response
{"project":"finance:boj", "data": {"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" } ],"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" } ],"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" } ],"lastUpdate":"2026-08-04","latestValue":-1.1,"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" },"timestamp":"2026-08-21T02:22:35Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:boj", "monetary-base", { lang: "en", from: "2025-01", to: "2026-07", length: 24 });