trace-trade-flows
Use this skill when the user asks about strategic commodity flows: crude oil, LNG, gold, semiconductors, arms-related categories, or anomalous year-over-year trade moves. The endpoint reads seeded UN Comtrade slices and sorts by recency and anomaly magnitude.
Entitlement: this operation is Pro-gated (entitlement tier >= 1). A key on the free tier receives 403.
Authentication
Server-to-server callers (agents, scripts, SDKs) MUST present an API key in the X-WorldMonitor-Key header. Authorization: Bearer ... is for MCP/OAuth or Clerk JWTs - not raw API keys.
X-WorldMonitor-Key: wm_0123456789abcdef0123456789abcdef01234567
Issue a key at https://www.worldmonitor.app/pro.
Endpoint
GET https://worldmonitor.app/api/trade/v1/list-comtrade-flows
Parameters
| Name | In | Required | Shape | Notes |
|---|---|---|---|---|
reporter_code | query | no | UN Comtrade reporter code | Example: 842 for the United States, 156 for China. Empty returns the curated reporter set. |
cmd_code | query | no | HS commodity code | Example: 2709 crude oil, 2711 gas, 7108 gold, 8542 semiconductors. |
anomalies_only | query | … |
