Securely Redirecting...

Connecting to Stripe

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.

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

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 and paid access. USD endpoints are available free without an API key.

Example Usage

To retrieve the Foreign Exchange Reserves data for JPY starting from the beginning of 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