Skip to main content
Bilateral commodity trade data from UN Comtrade, mirror data discrepancy detection, entity resolution, and sanctions cross-referencing.

​
GET /api/v1/trade-flows

Requires API key.
Bilateral trade flow data. Use ?view param for different analyses. Parameters
NameTypeRequiredDescription
viewstring’flows’ (default) | ‘mirror’ | ‘sanctions’ | ‘entity’
exporterstringExporter country name filter
importerstringImporter country name filter
commoditystringCommodity name filter (e.g. Wheat, Soybeans)
periodstringYear filter (e.g. ‘2024’)
limitnumberMax results (default 50)
Response 
{ "flows": [...] } or { "discrepancies": [...] } or { "matches": [...] } or { "entities": [...] }
Example 
curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/trade-flows?view=VALUE&exporter=VALUE

​
GET /api/v1/trade-flows?view=mirror

Mirror data discrepancies: exporter-reported vs importer-reported volumes for the same commodity/country pair. Large discrepancies signal trade re-routing or misclassification. Response 
{ "discrepancies": [{ "exporter_name", "importer_name", "commodity_name", "exported_mt", "imported_mt", "discrepancy_pct", "status" }] }
Example 
curl -X GET \
  https://axiomoverwatch.io/api/v1/trade-flows?view=mirror

​
GET /api/v1/trade-flows?view=sanctions

Vessels matched against OFAC sanctions list via IMO, MMSI, or name-based entity resolution. Response 
{ "matches": [{ "imo_number", "vessel_name", "sanctioned_entity", "list_source", "match_type" }], "match_types": { "direct_imo", "mmsi", "name" } }
Example 
curl -X GET \
  https://axiomoverwatch.io/api/v1/trade-flows?view=sanctions

​
GET /api/v1/trade-flows?view=entity

Supply chain entity graph: vessels linked to owners, ports, sanctions, P&I coverage, and dark fleet history. Parameters
NameTypeRequiredDescription
imostringFilter by IMO number
Response 
{ "entities": [{ "imo_number", "vessel_name", "port_name", "is_sanctioned", "dark_event_count", "risk_score" }] }
Example 
curl -X GET \
  https://axiomoverwatch.io/api/v1/trade-flows?view=entity?imo=VALUE