Securely Redirecting...

Connecting to Stripe

Back to API Index

Trade Balance (USD)

The difference between the value of a country's exports and imports of goods and services. A Trade Surplus (exports > imports) means foreigners need to buy the domestic currency to pay for the country's goods, creating demand for the currency (e.g., USD, EUR, AUD, GBP). A growing surplus is typically bullish for the currency, while a widening deficit is bearish.

Category: Economy

API Endpoint

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

Data Source

Primary Source

FRED (BEA)

Official Series ID

BOPGSTB

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 Trade Balance data for USD starting from the beginning of 2023: 

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