Asia Trade Flow Intelligence

Real-time aggregation of bilateral trade data from 3 authoritative international sources with trade risk scoring.

Purpose

This Actor analyzes trade flows between Asia-Pacific countries by combining official trade statistics and news sentiment:

• UN Comtrade - Official bilateral trade statistics (HS commodity codes, $USD value)
• World Bank - Country export volumes and economic indicators
• GDELT Project - Trade-related news volume (geopolitical sentiment indicator)

Produces a composite Trade Risk Score (0-100) combining data source availability and diversity.

Input

Required

• reporterCountry (string) — Two-letter ISO country code of exporting country (e.g., SG, KR, US)

Optional

• partnerCountry (string) — Two-letter ISO country code of importing country. If omitted, returns all partners.
• hsCode (string) — Harmonized System 6-digit commodity code (e.g., 8542 semiconductors, 8703 automobiles). If omitted, returns all commodities.
• year (number, default: 2022) — Reference year for trade data (2018-2024).

Output

{
  "query": {
    "reporterCountry": "SG",
    "partnerCountry": null,
    "hsCode": "8542",
    "year": 2023
  },
  "comtrade": {
    "totalTradeValueUsd": 45678900,
    "topPartners": [
      { "country": "US", "valueUsd": 12345678 },
      { "country": "CN", "valueUsd": 9876543 }
    ],
    "topCommodities": [
      { "hsCode": "8542", "valueUsd": 45678900 }
    ]
  },
  "worldBank": {
    "exportsValueUsd": 567890000,
    "lastUpdated": "2022"
  },
  "gdelt": {
    "totalTradeNewsArticles": 147,
    "topDomains": [
      { "domain": "reuters.com", "articles": 12 },
      { "domain": "bloomberg.com", "articles": 8 }
    ],
    "latestArticles": [
      {
        "title": "Singapore exports surge on semiconductor demand",
        "url": "https://example.com/article",
        "domain": "reuters.com",
        "date": "20260408T120000Z"
      }
    ]
  },
  "tradeRiskScore": 35,
  "dataAvailability": {
    "comtrade": true,
    "worldBank": true,
    "gdelt": true
  },
  "sources": [...],
  "disclaimer": "...",
  "timestamp": "2024-04-08T15:30:00Z"
}

Examples

Singapore Semiconductor Exports (2023)

{
  "reporterCountry": "SG",
  "hsCode": "8542",
  "year": 2023
}

South Korea to US (All Commodities)

{
  "reporterCountry": "KR",
  "partnerCountry": "US",
  "year": 2023
}

All Singapore Exports (All Partners, All Products)

{
  "reporterCountry": "SG",
  "year": 2023
}

Data Coverage

Country	UN Comtrade	World Bank	GDELT News
Singapore	✅	✅	✅
South Korea	✅	✅	✅
United States	✅	✅	✅
China	✅	✅	✅
Japan	✅	✅	✅
Thailand	✅	✅	✅
Malaysia	✅	✅	✅
Indonesia	✅	✅	✅
Philippines	✅	✅	✅
Vietnam	✅	✅	✅
Germany	✅	✅	✅
United Kingdom	✅	✅	✅
France	✅	✅	✅
Australia	✅	✅	✅
New Zealand	✅	✅	✅
India	✅	✅	✅
Brazil	✅	✅	✅
Mexico	✅	✅	✅
Canada	✅	✅	✅

Pricing

• $0.18 per trade query (Pay-per-Event model)
• Billed only when analysis completes successfully
• No charge if API fails

Trade Risk Score (0-100)

Lower scores indicate higher data availability (better/lower risk):

• 0-15: Excellent coverage (3/3 sources available)
• 16-50: Partial coverage (2/3 sources available)
• 51-100: Limited coverage (1/3 sources available)

⚠️ Legal Disclaimer

This Actor aggregates publicly available trade data from:

• UN Comtrade (CC-BY 3.0 IGO)
• The World Bank (CC-BY 4.0)
• GDELT Project (CC-BY 4.0)

NOT trade, investment, or business advice. This Actor provides historical data aggregation and news analysis only.

• Does NOT recommend trading partners, products, or market entry decisions
• Does NOT forecast future trade flows or tariff changes
• Does NOT constitute financial, legal, or customs advice
• Historical data does not predict future performance
• News volume does not imply opportunity or risk
• Users must verify data with original sources and consult professional advisors

Attribution:

• "Data source: UN Comtrade (CC BY 3.0 IGO)"
• "Data source: The World Bank (CC BY 4.0)"
• "Data source: GDELT Project (CC BY 4.0)"

Technical Details

• Runtime: Node.js 18+
• Timeout: 120 seconds per query
• Memory: ~128MB per run
• Concurrent API calls: 3 (parallel fetch)
• Data freshness: Real-time from source APIs
• Example year default: 2022 (for UN Comtrade data stability)

Support

For issues or questions, please contact the developer. Data accuracy is subject to source API availability and update frequency.

---

Last updated: 2026-04-08