Boj

Japan's monetary base and its components.

4 endpoints409 calls4/4 passing
Get API key
GET/v1/…boj/monetary-base
passing · 0.4s6h cache

Try it

Checking your keys…

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 });