Skip to main content
GET
/
api
/
trade
/
v1
/
list-comtrade-flows
ListComtradeFlows
curl --request GET \
  --url https://api.example.com/api/trade/v1/list-comtrade-flows
{
  "flows": [
    {
      "reporterCode": "<string>",
      "reporterName": "<string>",
      "partnerCode": "<string>",
      "partnerName": "<string>",
      "cmdCode": "<string>",
      "cmdDesc": "<string>",
      "year": 123,
      "tradeValueUsd": 123,
      "netWeightKg": 123,
      "yoyChange": 123,
      "isAnomaly": true
    }
  ],
  "fetchedAt": "<string>",
  "upstreamUnavailable": true
}

Query Parameters

​
reporter_code
string

UN Comtrade reporter code (e.g. "842" = US, "156" = China). Empty returns all reporters.

​
cmd_code
string

HS commodity code (e.g. "2709" = crude oil). Empty returns all commodities.

​
anomalies_only
boolean

If true, only return flows with a year-over-year change exceeding 30%.

Response

Successful response

ListComtradeFlowsResponse contains strategic commodity trade flows.

​
flows
object[]
​
fetchedAt
string

ISO 8601 timestamp when data was seeded.

​
upstreamUnavailable
boolean

True if seeded data is missing or stale.