Skip to main content
GET
GetMonthlySitcTrade

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

country
string

ISO 3166-1 alpha-2 reporter. Empty selects "MY".

Pattern: ^([A-Z]{2})?$
sections
string[]

SITC sections to return: "0" (food and live animals) through "9", or "overall" (all goods). Empty returns every section. Food-security callers typically ask for 0 (food), 1 (beverages and tobacco) and 4 (animal and vegetable oils and fats).

Maximum array length: 11
Pattern: ^([0-9]|overall)$
months
integer<int32>

Number of months to return, counted back from the newest seeded month and including it. 0 selects the default of 60; the maximum of 480 covers the full seeded history, which starts in January 1990.

Required range: 0 <= x <= 480
jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

Response with a country's monthly trade by SITC section.

country
string

ISO 3166-1 alpha-2 reporter that was resolved, for example "MY".

currency
string

ISO 4217 currency of exports and imports, for example "MYR".

source
string

Publisher and dataset, for example "DOSM Monthly Trade by SITC Section".

sourceUrl
string

Publisher dataset page.

indexBase
string

Base period of the unit value and volume indices, for example "2010=100".

latestMonth
string

Newest month with trade values, YYYY-MM. Empty when no series are returned.

latestIndexMonth
string

Newest month with unit value and volume indices, YYYY-MM.

fetchedAt
integer<int64>

When the seed fetched the publisher files, as Unix epoch milliseconds. 0 when no seed was served.. Warning: Values > 2^53 may lose precision in JavaScript

series
object[]
upstreamUnavailable
boolean

True when series could not be served because of a fault: a covered country whose cache entry is gone, or a cache read that failed. False when series are served and when the country is simply not covered.

unavailableReason
enum<string>

TradeFlowUnavailableReason says why no rows were returned. The distinction that matters is NOT_COVERED — a contract answer, nothing is broken and a retry cannot help — against every other member, which names a fault.

Available options:
TRADE_FLOW_UNAVAILABLE_REASON_UNSPECIFIED,
TRADE_FLOW_UNAVAILABLE_REASON_INVALID_REQUEST,
TRADE_FLOW_UNAVAILABLE_REASON_NOT_COVERED,
TRADE_FLOW_UNAVAILABLE_REASON_SEED_MISSING,
TRADE_FLOW_UNAVAILABLE_REASON_COVERAGE_UNKNOWN,
TRADE_FLOW_UNAVAILABLE_REASON_CACHE_UNAVAILABLE