What it returns
Bank of Japan statistics from its official Time-Series Data Search API, as flat rows with ISO periods and units. - **Presets**: `policy-rates` (uncollateralized overnight call rate, daily; basic loan rate), `fx` (USD/JPY 17:00 Tokyo, daily and monthly average), `money` (monetary base and M2, level and year-on-year), `producer-prices` (PPI all commodities, index and year-on-year), `tankan` (business conditions DI, large manufacturers, non-manufacturers and all industries, actual and forecast) - **Any series**: `database` + `codes` - **Search**: `database` + `search` lists series codes, names, frequency and coverage
| field | meaning |. |---|---|. | `database`, `code`, `name`, `category` | the BOJ series |. | `frequency`, `period` | DAILY / MONTHLY / QUARTERLY, and `2026-10-15`, `2026-09`, `2026Q3` |. | `value`, `unit` | the figure and its unit as published |. | `lastUpdate`, `preset`, `source` | when the BOJ last updated it, the preset used, the BOJ database page |. Tankan periods are survey quarters; forecast series run one quarter ahead.
Request
POST https://api.pushbuild.com/bank-of-japan-data/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
presets | list of strings | Any of: policy-rates, fx, money, producer-prices, tankan. Default (when no codes are given): policy-rates, fx, money, tankan. |
database | string | BOJ database code for codes or search, e.g. FM01 (call rates), FM08 (FX), IR01 (basic loan rate), MD01 (monetary base), MD02 (money stock), PR01 (producer prices), PR02 (services producer prices), CO (Tankan). |
codes | list of strings | Series codes in that database, e.g. FXERD04. Find them with search. |
lastN | integer | Latest observations per series, used when no start date is given. Default: 12. |
startDate | string | YYYY-MM. Returns everything from that month. |
endDate | string | YYYY-MM. |
search | string | Words to find in series codes, names and categories of the given database. Returns matching series instead of data. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/bank-of-japan-data/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"presets": ["policy-rates", "fx"], "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 values. No charge for errors or empty searches.
Related APIs
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BIS Statistics API: Global Policy Rates, House Prices & Credit API
Bank for International Settlements data for 40-60 economies: central bank policy rates (daily or monthly), real residential property prices, credit-to-GDP gaps, effective exchange rates, USD exchange rates and CPI inflation, or any BIS dataflow by SDMX key..
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Brazil Central Bank API: Focus Survey Expectations & PTAX FX API
Banco Central do Brasil Focus survey of market expectations (IPCA, Selic per Copom meeting, GDP, BRL/USD, IGP-M, fiscal and external accounts: median, mean, spread, respondents) and official PTAX exchange rates for USD, EUR and other currencies..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com