Back to API Index

Viðskiptajöfnuður (BRL)

Mismunurinn á virði útflutnings og innflutnings lands.

Latest reading: 6.127 (2016-05-31)  ·  USD bn

Category: Economy

API Endpoint

/api/v1/announcements/brl/trade_balance

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

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

Browse the full endpoint reference

Compare Viðskiptajöfnuður across all supported currencies →

About Viðskiptajöfnuður (BRL)

Brazil's trade balance measures the difference between its exports and imports of goods and services over a given period. A positive balance (surplus) means exports exceed imports; a deficit is the reverse.

Why FX traders watch it

Trade surpluses require foreign buyers to acquire brl to pay for Brazil exports, creating structural demand for the currency. Large and persistent deficits can create sustained downward pressure on the brl.

How to interpret the data

A widening trade surplus or a narrowing deficit is broadly brl-positive. A deteriorating trade balance—especially driven by weaker export volumes—may signal slowing global demand and can weigh on the brl.

Historical Viðskiptajöfnuður (BRL)

Source: BCB SGS  ·  Monthly  ·  USD bn

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

Data Source

Primary Source

BCB SGS

Official Series ID

SGS/22707

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": "BRL",
    "indicator": "trade_balance",
    "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 Viðskiptajöfnuður data for BRL from 2023: 

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

Frequently Asked Questions

How does a trade surplus affect the brl?
Export revenues generate demand for the domestic currency as foreign buyers convert their currency to pay Brazil exporters. Persistent surpluses create structural buying pressure.