Back to API Index

Retail Sales (JPY)

Measures change in the total value of sales at the retail level.

Latest reading: 11529.0 %YoY · Last updated: · Source: BoJ/Statistics Japan

Category: Economy

API Endpoint

/api/v1/announcements/jpy/retail_sales

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

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

Browse the full endpoint reference

Compare Retail Sales across all supported currencies →

About Retail Sales (JPY)

Retail sales for Japan measures the total receipts at retail stores, capturing consumer spending on goods. It is a high-frequency proxy for consumer demand and GDP growth.

Why FX traders watch it

Consumer spending accounts for 60–70% of GDP in most developed economies. Strong retail sales indicate healthy household finances and tend to support the jpy by reducing the probability of rate cuts.

How to interpret the data

A beat on retail sales is jpy-positive and may delay rate cuts. A sustained decline in retail sales signals consumer stress, which could prompt the Bank of Japan to ease, weakening the jpy.

Historical Retail Sales (JPY)

Source: BoJ/Statistics Japan  ·  Monthly  ·  %YoY

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

Data Source

Primary Source

BoJ/Statistics Japan

Official Series ID

0000078665

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

%YoY

JSON Response Structure

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

{
    "currency": "JPY",
    "indicator": "retail_sales",
    "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 Retail Sales data for JPY from 2023: 

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

Frequently Asked Questions

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