Back to API Index

Oferta Monetária M2 (JPY)

M1 + depósitos de poupança (à vista). RBNZ derivado: coluna A + B1.

Latest reading: 12954117.0 JPY tn · Last updated: · Source: BoJ/Statistics Japan

Category: Money & Credit

API Endpoint

/api/v1/announcements/jpy/m2

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Compare Oferta Monetária M2 across all supported currencies →

About Oferta Monetária M2 (JPY)

M2 money supply for Japan adds savings accounts, money market funds, and small time deposits to M1, providing a broader measure of the money stock. It is the most commonly referenced broad money aggregate in policy analysis.

Why FX traders watch it

M2 growth is a key input to monetarist models of inflation. The Bank of Japan monitors M2 to assess the pace of credit creation and liquidity in the economy. Rapid M2 expansion can be a precursor to inflation.

How to interpret the data

Above-trend M2 growth over 6–12 months is a medium-term inflation risk and can support a hawkish Bank of Japan stance, which is jpy-positive. Contracting M2 (as seen in some post-QE tightening periods) signals deflationary pressure.

Historical Oferta Monetária M2 (JPY)

Source: BoJ/Statistics Japan  ·  Monthly  ·  JPY tn

Data provided by FXMacroData via the /api/v1/announcements/jpy/m2 endpoint. For access, see pricing.

Data Source

Primary Source

BoJ/Statistics Japan

Official Series ID

MD02'FCMA00_01

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

JPY tn

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

{
    "currency": "JPY",
    "indicator": "m2",
    "has_official_forecast": false,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "data": [
        {
            "date": "2024-07-01",
            "val": 4.2,
            "announcement_datetime": 1722456000
        }
    ]
}

Request Parameters & Usage

Parameter Required Format Description
start_date NO YYYY-MM-DD Optional lower bound for the requested history.
end_date NO YYYY-MM-DD Optional upper bound. Defaults to the current date.
api_key CONDITIONAL string Required for non-USD announcement requests. USD announcement requests are public without an API key.

Example Usage

To retrieve Oferta Monetária M2 data for JPY from 2023: 

GET https://fxmacrodata.com/api/v1/announcements/jpy/m2?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY

Frequently Asked Questions

How often is Japan M2 Money Supply updated?
M2 Money Supply for Japan is released on a monthly schedule by Bank of Japan (or the relevant national statistics agency). FXMacroData ingests each new value within seconds of the official publication and exposes the exact announcement timestamp on every record.
What unit is M2 Money Supply reported in?
The series is published in JPY tn. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Japan M2 Money Supply data?
Data is fetched directly from Bank of Japan or the official national statistics publication for Japan. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
How do I query M2 Money Supply for Japan via the API?
Issue a GET request to /api/v1/announcements/jpy/m2?api_key=YOUR_API_KEY. The response contains a chronological list of observations with values, release dates, and announcement timestamps. USD announcement data is public; other currencies require a Professional API key.