Securely Redirecting...

Connecting to Stripe

Back to API Index

Retail Sales (USD)

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

Category: Economy

API Endpoint

/api/usd/retail_sales
Or view detailed, interactive documentation: Open Swagger Docs

Data Source

Primary Source

FRED (Census)

Official Series ID

RSAFS

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

Millions of USD

JSON Response Structure

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

[
  {
    "date": "YYYY-MM-DD", 
    "val": 0.00
  },
  {
    "date": "2024-07-01", 
    "val": 4.2 
  },
  // ... history 
]

Request Parameters & Usage

Parameter Required Format Description
start YES YYYY-MM-DD The start date for the data retrieval.
end NO YYYY-MM-DD The end date for the data retrieval. Defaults to today's date.
key YES string Your unique API key for authentication.

Example Usage

To retrieve the Retail Sales data for USD starting from the beginning of 2023: 

GET https://fxmacrodata.com/api/usd/retail_sales?start=2023-01-01&key=YOUR_API_KEY