Global Economy & Trade

IMF Direction of Trade - bilateral goods trade and trade balance

Changed on

IMF Direction of Trade Statistics (IMTS), via the public SDMX 3.0 API.

Goods exports (FOB), imports (CIF) and the trade balance of any reporter country against its partner countries, monthly, quarterly or annual. direction=balance (the default) returns the trade balance.

Source: International Monetary Fund, Direction of Trade Statistics.

get/api/v1/imf/direction-of-trade

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/imf/direction-of-trade
  • Auth: API key in header x-api-key

Query parameters

countrystring required

Reporter country/countries: ISO3 code, snake_case name, or 'all'. Comma-separate for several (max 8).

Example:united_states
counterpartstring required

Partner country/countries: ISO3 code, snake_case name, or 'all'. Comma-separate for several (max 8). country and counterpart cannot both be 'all'.

Example:china
directionstring

exports, imports, balance, or all.

frequencystring

month, quarter, or annual.

start_datestring nullable

Inclusive lower bound (YYYY-MM-DD).

end_datestring nullable

Inclusive upper bound (YYYY-MM-DD).

limitinteger nullable

Most-recent N observations per series.

Response

Bilateral trade values (exports FOB / imports CIF / balance).

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes