Back to API Index

تراز تجاری (CNY)

تفاوت بین ارزش صادرات و واردات یک کشور.

Category: Economy

API Endpoint

/api/v1/announcements/cny/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 تراز تجاری across all supported currencies →

About تراز تجاری (CNY)

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

How to interpret the data

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

Historical تراز تجاری (CNY)

Source: NBS/PBoC  ·  Monthly  ·  USD bn

Chart data not available. Access the full historical series via the API endpoint above.

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

Data Source

Primary Source

NBS/PBoC

Official Series ID

NBS/A060101_zb

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": "CNY",
    "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 تراز تجاری data for CNY from 2023: 

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