War Tracker
API aggregates daily Strait of Hormuz vessel transit analytics including directional counts, operator rankings, and flag classifications.
Trust signal
4 of 4 pillars
coverage 100%
Pillars
Signals
Evidence tiers, not an endorsement · trust model v0.1.0 (provisional) · CDP-lane settlement only (D3) · Trust API coming soon
On-chain traction
ERC-8004 agent registry
Not found in the ERC-8004 agent registry. This is the default state — absence is not a negative signal.
Identity & classification
Settlement volume
USDC settled on-chain · monthly
as of Jul 12, 2026
Endpoints(32)
Single event at /api/v1/events/{id}. Returns canonical JSON: scalar fields (id, date, country, event_type, lat/lng), headline, TL;DR, article paragraphs, full schema.org JSON-LD @graph (NewsArticle + Event + VideoObject + BreadcrumbList + FAQPage), thumbnail (free), media URL (paid via /media/{id}), transcript when available, FAQ, super-event metadata. Equivalent to /share/{id}/{slug} with Accept: application/json.
Single vessel identity by IMO. Returns scalar identity: name, MMSI, flag (ISO-3166-1 alpha-2), AIS type (e.g. `Tanker`, `Cargo`, `Fishing`), subtype (e.g. `Crude Oil Tanker`), commercial market (13-value enum: `WET BULK`, `DRY BULK`, `CONTAINER SHIPS`, …), overall length in metres, year built, and the boolean `sanctioned` / `watchlisted` rollups across OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT, and the War-Tracker OSINT shadow-fleet watchlist. Free for browsers, AI-search crawlers…
Latest AIS position for one vessel by IMO. Returns lat/lon (WGS84), speed over ground (`sog`, knots), course over ground (`cog`, degrees true 0-360), AIS destination string (free-form, operator-entered), captured-at UTC, and `age_seconds` since the ping was received. Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs (GPTBot, ClaudeBot, CCBot, …). AIS pings arrive every 1-180 s depending on vessel speed and satellite/terrestrial coverage —…
Sanctions + watchlist rollup for one vessel by IMO. Joins our internal mirrors of the 9 sanctioning bodies (OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT) plus the War-Tracker OSINT shadow-fleet watchlist, and returns every body that has ever listed the vessel along with the listing date per body, plus structured watchlist context (`reason`, `severity`, `source`, first/last-updated UTC). Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs…
Single vessel identity by IMO. Returns scalar identity: name, MMSI, flag (ISO-3166-1 alpha-2), AIS type (e.g. `Tanker`, `Cargo`, `Fishing`), subtype (e.g. `Crude Oil Tanker`), commercial market (13-value enum: `WET BULK`, `DRY BULK`, `CONTAINER SHIPS`, …), overall length in metres, year built, and the boolean `sanctioned` / `watchlisted` rollups across OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT, and the War-Tracker OSINT shadow-fleet watchlist. Free for browsers, AI-search crawlers…
Latest AIS position for one vessel by IMO. Returns lat/lon (WGS84), speed over ground (`sog`, knots), course over ground (`cog`, degrees true 0-360), AIS destination string (free-form, operator-entered), captured-at UTC, and `age_seconds` since the ping was received. Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs (GPTBot, ClaudeBot, CCBot, …). AIS pings arrive every 1-180 s depending on vessel speed and satellite/terrestrial coverage —…
Sanctions + watchlist rollup for one vessel by IMO. Joins our internal mirrors of the 9 sanctioning bodies (OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT) plus the War-Tracker OSINT shadow-fleet watchlist, and returns every body that has ever listed the vessel along with the listing date per body, plus structured watchlist context (`reason`, `severity`, `source`, first/last-updated UTC). Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs…
Single vessel identity by IMO. Returns scalar identity: name, MMSI, flag (ISO-3166-1 alpha-2), AIS type (e.g. `Tanker`, `Cargo`, `Fishing`), subtype (e.g. `Crude Oil Tanker`), commercial market (13-value enum: `WET BULK`, `DRY BULK`, `CONTAINER SHIPS`, …), overall length in metres, year built, and the boolean `sanctioned` / `watchlisted` rollups across OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT, and the War-Tracker OSINT shadow-fleet watchlist. Free for browsers, AI-search crawlers…
Latest AIS position for one vessel by IMO. Returns lat/lon (WGS84), speed over ground (`sog`, knots), course over ground (`cog`, degrees true 0-360), AIS destination string (free-form, operator-entered), captured-at UTC, and `age_seconds` since the ping was received. Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs (GPTBot, ClaudeBot, CCBot, …). AIS pings arrive every 1-180 s depending on vessel speed and satellite/terrestrial coverage —…
Sanctions + watchlist rollup for one vessel by IMO. Joins our internal mirrors of the 9 sanctioning bodies (OFAC, FCDO, EU, UANI, ASO, GAC, UN, SECO, MFAT) plus the War-Tracker OSINT shadow-fleet watchlist, and returns every body that has ever listed the vessel along with the listing date per body, plus structured watchlist context (`reason`, `severity`, `source`, first/last-updated UTC). Free for browsers, AI-search crawlers, and link-preview bots; paid via x402 for training-crawler UAs…
Country hub page at /country/{iso2}. Aggregates conflict events for a single sovereign nation, keyed by ISO-3166-1 alpha-2. HTML with embedded CollectionPage + Dataset JSON-LD pointing back at /api/v1/events?country={iso2}.
Event-type hub page at /event-type/{slug}. Aggregates events matching one classification slug (e.g. drone-strike, airstrike, skirmish). HTML with embedded CollectionPage + Dataset JSON-LD pointing back at /api/v1/events?event_type={slug}.
Event-type hub page at /event-type/{slug}. Aggregates events matching one classification slug (e.g. drone-strike, airstrike, skirmish). HTML with embedded CollectionPage + Dataset JSON-LD pointing back at /api/v1/events?event_type={slug}.
Region hub page at /region/{slug}. Aggregates conflict events for a single region (continent, sub-continent, or maritime bbox). HTML with embedded CollectionPage + Dataset JSON-LD that points back at /api/v1/events?region=… so agents can read the JSON-LD instead of scraping the DOM.
Region hub page at /region/{slug}. Aggregates conflict events for a single region (continent, sub-continent, or maritime bbox). HTML with embedded CollectionPage + Dataset JSON-LD that points back at /api/v1/events?region=… so agents can read the JSON-LD instead of scraping the DOM.
Per-event article at /share/{id}/{slug}. Default response is the SEO-canonical HTML page with an embedded JSON-LD @graph (NewsArticle + VideoObject + FAQPage). Content-negotiable: send `Accept: application/json` or `application/ld+json` to receive the same data as a pure JSON payload (the same shape as /api/v1/events/{id}). One payment covers either representation.
Per-event article at /share/{id}/{slug}. Default response is the SEO-canonical HTML page with an embedded JSON-LD @graph (NewsArticle + VideoObject + FAQPage). Content-negotiable: send `Accept: application/json` or `application/ld+json` to receive the same data as a pure JSON payload (the same shape as /api/v1/events/{id}). One payment covers either representation.
Faceted vessel-identity search across the ~600k-vessel MarineTraffic mirror. Supports free-text `q` (matches name prefix, IMO, or MMSI), facet filters (`flag`/country_code, AIS `type`, `subtype`, `commercial_market_name`), boolean `sanctioned` and `watchlisted` flags, and numeric `min_length` (metres) / `min_year_built` filters. **Always enumerate legal facet values via the free /api/v1/vessels/facets endpoint before paying for /search** — otherwise probing unknown facet values burns $0.002…
Paginated event corpus at /api/v1/events (up to 200 rows per call).
Daily aggregate analytics for the Strait of Hormuz transit feed (ShipTracker-sourced). Single paid call returns three rollups in one response: (a) `daily_counts` — per-UTC-day transit counts split by direction (`direction_0` / `direction_1` / `direction_unknown`), `total`, `sanctioned`, `watchlisted`, and `distinct_operators` for each day; (b) `top_operators` — top 10 operator companies by crossing count over the window with their `sanctioned_crossings` share; (c) `top_flags` — top 10 flag…
Paginated feed of individual vessel transits through the Strait of Hormuz, sourced from the ShipTracker live AIS feed. One row per (vessel, direction, crossing-day). Each row carries `dt_utc` (UTC day), MMSI + resolved IMO, vessel name and shiptype, flag (`country_code`), operator company, deadweight tonnage (`dwt`), `direction` (0 or 1), `time1` / `time2` (ShipTracker first/second-cross timestamps), and the `sanctioned` / `watchlisted` flags resolved against our internal mirror of OFAC + 8…
Recent AIS position polyline for one vessel by IMO. Response shape: `{imo, hours_requested, hours_effective, raw_points_in_window, downsample_step, points: [{captured_utc, lat, lon, sog, cog}, …]}` — ordered oldest-first so a client can plot the track without sorting. The `?hours=` parameter is currently clamped to 1 (anything wider is silently rolled back — the param stays in the route signature so we can ship longer windows as higher-priced tiers without a rename). When the raw window…
Recent AIS position polyline for one vessel by IMO. Response shape: `{imo, hours_requested, hours_effective, raw_points_in_window, downsample_step, points: [{captured_utc, lat, lon, sog, cog}, …]}` — ordered oldest-first so a client can plot the track without sorting. The `?hours=` parameter is currently clamped to 1 (anything wider is silently rolled back — the param stays in the route signature so we can ship longer windows as higher-priced tiers without a rename). When the raw window…
Recent AIS position polyline for one vessel by IMO. Response shape: `{imo, hours_requested, hours_effective, raw_points_in_window, downsample_step, points: [{captured_utc, lat, lon, sog, cog}, …]}` — ordered oldest-first so a client can plot the track without sorting. The `?hours=` parameter is currently clamped to 1 (anything wider is silently rolled back — the param stays in the route signature so we can ship longer windows as higher-priced tiers without a rename). When the raw window…
Distinct vessels with at least one AIS ping inside a bounding box (`min_lat`/`min_lon`/`max_lat`/`max_lon` in WGS84) over the last `hours` hours. Page size locked at 10 vessels per paid call. Each row carries identity + last ping (`last_lat`, `last_lon`, `last_sog`, `last_cog`, `last_ping_utc`, `destination`) + the sanctioned/watchlisted booleans. Optional facet filters mirror /vessels/search: `flag`, `type`, `subtype`, `commercial_market_name`, `sanctioned`, `watchlisted`. Pagination is…
Full media bytes (photo or video) for an event at /media/{event_id}. Flat price.
Cursor-paginated sanctioned / shadow-fleet vessel feed. Each row carries identity + last known AIS position + the set of sanctioning bodies that have listed the vessel. Optional `?body=` (ofac, fcdo, uani, eu, aso, gac, un, seco, mfat), `?active_only=true`, and `?flag=` filters. Hard cap of 10 rows/page — one paid call per page. Rows ordered by IMO ascending; pass back `next_cursor` as `?cursor=` to fetch the next page. The full ~1.4 k-row dump costs ~$3.50 to walk.