Boj Series
boj_seriesAny Bank of Japan statistics time series by database id and series code: money stock and monetary base, TANKAN, corporate goods price index, flow of funds, loans and deposits, balance of payments. Returns name, unit, frequency, last update date, observations and a computed YoY percentage for monthly, quarterly and annual series. A period the BOJ has not published yet returns reason not_yet_published with the latest available value. Find codes with boj_series_list.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"db": "MD02",
"code": "MAM1NAM2M2MO",
"start": "2026-07"
},
"name": "boj_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | Yes | BOJ database id, e.g. 'MD02' (money stock), 'MD01' (monetary base). | |
| end | No | Last period, same format. | |
| code | Yes | Series code, e.g. 'MAM1NAM2M2MO' (M2 average amounts outstanding). | |
| limit | No | Max observations returned (default 24, max 240). | |
| start | No | First period: '2026-01', '2026Q1' or '2026' depending on frequency. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | BOJ database id | |
| code | No | Series code | |
| hint | No | Next step | |
| name | No | Series name | |
| unit | No | Unit as published | |
| found | No | Whether data was found | |
| notes | No | ||
| latest | No | One observation | |
| reason | No | not_yet_published, series_not_found, no_observations, no_observations_in_range, database_not_found, no_matching_series, database_too_large_to_list | |
| source | No | Publisher and dataset | |
| measure | No | Money stock measure label | |
| message | No | Explanation when found is false | |
| category | No | Series category | |
| frequency | No | monthly, quarterly or annual | |
| requested | No | Requested period (not_yet_published) | |
| data_as_of | No | Newest period in the series | |
| last_update | No | Date the BOJ last updated the series (YYYYMMDD) | |
| observations | No | ||
| series_range | No | First and last period | |
| observation_count | No | Observations returned | |
| latest_available_value | No | Newest published value (not_yet_published) | |
| latest_available_period | No | Newest published period (not_yet_published) |