Back to API Index

Trade Balance (NZD)

The difference between the value of a country's exports and imports.

Latest reading: 886.0 (2016-06-30)  ·  NZD mn

Category: Economy

API Endpoint

/api/v1/announcements/nzd/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 Trade Balance across all supported currencies →

About Trade Balance (NZD)

New Zealand'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 nzd to pay for New Zealand exports, creating structural demand for the currency. Large and persistent deficits can create sustained downward pressure on the nzd.

How to interpret the data

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

Historical Trade Balance (NZD)

Source: RBNZ/Stats NZ  ·  Monthly  ·  NZD mn

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

Data Source

Primary Source

RBNZ/Stats NZ

Official Series ID

MOSG

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

NZD mn

JSON Response Structure

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

{
    "currency": "NZD",
    "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 Trade Balance data for NZD from 2023: 

GET https://fxmacrodata.com/api/v1/announcements/nzd/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 nzd?
Export revenues generate demand for the domestic currency as foreign buyers convert their currency to pay New Zealand exporters. Persistent surpluses create structural buying pressure.