Trade Routes

Trade flow analysis, route shifts, and destination deceptions.

`GET` `/api/v1/routes/flows`

Trade route flows between ports with tonnage and market share. Parameters

Name	Type	Description
`origin`	string	Origin port ID
`destination`	string	Destination port ID
`week`	string	Week start date (ISO)
`commodity`	string	Commodity filter
`limit`	number	Default 100, max 500

Response

{ "flows": [...] }

Example

curl -X GET \
  https://axiomoverwatch.io/api/v1/routes/flows?origin=VALUE&destination=VALUE

Detected trade route shifts and deviations. Parameters

Name	Type	Description
`severity`	string	’moderate’ \| ‘high’ \| ‘critical’
`origin`	string	Origin port ID
`commodity`	string	Commodity filter
`limit`	number	Default 100, max 500

Response

{ "shifts": [...] }

Example

curl -X GET \
  https://axiomoverwatch.io/api/v1/routes/shifts?severity=VALUE&origin=VALUE

Vessels whose actual destination didn’t match declared destination. Parameters

Name	Type	Description
`vessel`	string	IMO number
`suspicious`	string	’true’ \| ‘false’
`actual_port`	string	Actual port ID
`limit`	number	Default 100, max 500

Response

{ "deceptions": [...] }

Example

curl -X GET \
  https://axiomoverwatch.io/api/v1/routes/deceptions?vessel=VALUE&suspicious=VALUE

⌘I