Skip to main content
The Axiom Overwatch API exposes 70+ endpoints across vessel tracking, risk intelligence, commodity flows, satellite imagery, P&I coverage, trade flows, and more.

​
Base URL

https://axiomoverwatch.io/api/v1

​
Authentication

Most read-only endpoints are open to the public. Endpoints that return user-specific data, mutating endpoints, and high-volume reads require an API key. Pass the key via the X-API-Key header: 
curl -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/positions?port=houston
Generate keys in Settings → API Keys in the Overwatch dashboard.

​
Access tiers

PlanRate limitHistory depthFeatures
Free60 req/min7 daysPublic endpoints, ports, basic positions
Starter600 req/min30 daysAll read endpoints, exports up to 1k rows
Pro6,000 req/minFullAll endpoints, webhooks, priority sync, 10k row exports
Supply Chain RiskCustomFullPro + dark fleet alerts, custom risk scoring, dedicated support
See /api/v1/billing/plans for live pricing.

​
Rate limiting

Rate limit headers are returned on every response:
  • X-RateLimit-Limit — your tier’s per-minute limit
  • X-RateLimit-Remaining — requests remaining in the current window
  • X-RateLimit-Reset — UTC epoch seconds when the window resets
When you exceed the limit, you’ll get HTTP 429 with a Retry-After header.

​
Response format

All endpoints return JSON with the data nested under a top-level key matching the resource (e.g. vessels, positions, events). Errors return: 
{ "error": "human-readable message", "code": "machine_readable_code" }

​
Methodology

Every endpoint that returns inferred or modeled data (cargo estimates, risk scores, dark fleet detections, draft anomalies) includes:
  • A confidence or tier field indicating signal strength
  • A methodology link in the response or in the endpoint docs
For modeling specifics, see the Methodology section.

​
Port slugs

Ports are referenced by slug (e.g. houston, santos, singapore, rotterdam). Get the full list from GET /api/v1/ports.

​
Quick start

# 1. List monitored ports
curl https://axiomoverwatch.io/api/v1/ports

# 2. Get latest vessel positions at a port
curl https://axiomoverwatch.io/api/v1/positions?port=houston

# 3. Pull risk-scored vessels (auth required for full data)
curl -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/risk/vessels?tier=critical

​
SDK + MCP

  • Python: pip install axiom-overwatch — see SDKs & MCP.
  • MCP server: lets Claude / GPT / any MCP-compatible AI agent query Overwatch directly.

​
Where to from here

Browse the endpoints by category in the sidebar, or jump to the most-used groups:

Vessels & Positions

Real-time AIS positions and vessel registry

Risk Intelligence

Dark fleet, STS, loitering, identity changes

Trade Flows

Bilateral commodity trade, mirror discrepancies, sanctions

Emissions

CSRD/SEC Scope 3 maritime emissions reports