Back to API Index

Foreign Exchange Reserves (JPY)

Assets held by the central bank in foreign currencies, used to support the exchange rate and manage monetary policy. Key indicator of a country's external financial position.

Latest reading: 1169425.0 USD bn · Last updated: · Source: BoJ/Statistics Japan

Category: Monetary Policy

API Endpoint

/api/v1/announcements/jpy/foreign_reserves

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

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

Browse the full endpoint reference

Compare Foreign Exchange Reserves across all supported currencies →

About Foreign Exchange Reserves (JPY)

The foreign reserves of Japan encompass foreign currency holdings, special drawing rights (SDRs), IMF reserve positions, and gold held by the Bank of Japan. They represent the country's international liquidity buffer.

Why FX traders watch it

A large reserves buffer increases confidence in the jpy by demonstrating the Bank of Japan's capacity to meet external obligations and intervene in FX markets. Reserves below 3 months of import cover are often cited as a vulnerability threshold.

How to interpret the data

Increasing foreign reserves are jpy-positive as they signal financial strength and intervention capacity. A sustained draw-down of reserves can trigger speculative attacks on the jpy.

Historical Foreign Exchange Reserves (JPY)

Source: BoJ/Statistics Japan  ·  Monthly  ·  USD bn

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

Data Source

Primary Source

BoJ/Statistics Japan

Official Series ID

FF

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

USD bn

JSON Response Structure

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

{
    "currency": "JPY",
    "indicator": "foreign_reserves",
    "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 Foreign Exchange Reserves data for JPY from 2023: 

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

Frequently Asked Questions

How often is Japan Foreign Exchange Reserves updated?
Foreign Exchange Reserves 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 Foreign Exchange Reserves reported in?
The series is published in USD bn. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Japan Foreign Exchange Reserves 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 Foreign Exchange Reserves for Japan via the API?
Issue a GET request to /api/v1/announcements/jpy/foreign_reserves?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.