The live picture, free. Depth, metered.

All-in-one bundle: verdict, live oil prices, IMF PortWatch daily transit count + throughput, AIS concurrent presence overlay, insurance multiple, trade impact, carrier suspensions, pipeline bypass, SPR, gas, and a per-section dataHealth chip. Powers the embed widget; recommended starting point for newsroom integrations.

curl https://straits.live/status

{
  "asOf": "2026-06-10T16:50:00Z",
  "status": "restricted",
  "verdict": { "status": "closed", "short": "No", "long": "…", "basis": "carriers" },
  "brent": 93.99, "wti": 91.04, "change24h": 4.25,
  "transits": { "count": 2, "baseline": 88, "throughputPct": 2, "asOfDate": "2026-06-07" },
  "insurance": { "multiple": 8, "vlccPremiumLow": 125000, "vlccPremiumHigh": 2500000 },
  "hormuzIndex": { "crisisPressure": { "value": 94 }, "escalationProbability": { "value": 68 } },
  "carrierSuspensions": [ … ],
  "dataHealth": { "ships": { "source": "live" }, "oil": { "source": "live" }, … }
}

Rolling Brent and WTI prices from intraday continuous futures (Yahoo Finance chart data, EIA daily backstop). Companion to /data/oil.csv for programmatic consumers.

Querylimit (default 168 ≈ 7 days hourly, max 2000), since (ISO timestamp)

curl 'https://straits.live/api/v1/oil?limit=2'

{
  "asOf": "2026-06-10T17:23:00Z",
  "count": 2,
  "source": "Intraday Brent / WTI continuous futures …",
  "points": [
    { "t": 1781110302601, "iso": "2026-06-10T16:51:42Z", "brent": 93.99, "wti": 91.06 },
    { "t": 1781112144785, "iso": "2026-06-10T17:22:24Z", "brent": 94.12, "wti": 91.20 }
  ]
}

Top Hormuz / Iran-conflict / oil-shock contracts from Kalshi (api.elections.kalshi.com) and Polymarket (gamma-api.polymarket.com). Strict keyword filter to avoid sweeping in election or macro contracts.

Querylimit (default 20, max 50), venue (kalshi | polymarket)

curl 'https://straits.live/api/v1/markets?venue=polymarket&limit=1'

{
  "asOf": "2026-06-10T17:23:00Z",
  "count": 1,
  "markets": [
    { "id": "polymarket_665374", "venue": "polymarket",
      "title": "Will the U.S. invade Iran before 2027?",
      "probability": 0.175, "volumeUsd": 35039246.83,
      "closeAt": "2026-12-31T00:00:00Z",
      "sourceUrl": "https://polymarket.com/…" }
  ]
}

Per-state regular-grade averages plus a national mean computed across the 50 states + DC.

Querystates (1 / true to include the per-state list; default omitted for payload size)

The dashboard's authoritative throughput figure. Carries the per-type breakdown (tanker, cargo, container, dry bulk, general cargo, Ro-Ro), capacity in deadweight tonnage, the trailing 30-day rolling baseline median, and a separate pre-crisis baseline median (fixed window: the final pre-crisis year, 2025-02-28 to 2026-02-27) used as the stable peacetime anchor. Not a programmer? The same series is a readable day-by-day table at /how-many-ships-passed-through-the-strait-of-hormuz-today.

Queryhistory (1 / true to include chokepointTransitsHistory rows), limit (default 90, max 365)

curl https://straits.live/api/v1/transits

{
  "asOf": "2026-06-10T17:23:00Z",
  "methodology": "IMF PortWatch daily vessel transit count …",
  "latest": {
    "date": "2026-06-07",
    "nTotal": 2, "nTanker": 1, "nCargo": 1, "nContainer": 0,
    "capacity": 68817,
    "baselineMedian": 4,
    "preCrisisBaselineMedian": 88
  }
}

Side-by-side daily counts for Hormuz, Bab el-Mandeb, Suez, the Cape of Good Hope, and Malacca, sorted Hormuz first, then by nTotal / preCrisisBaselineMedian ascending so the most-disrupted route rises to the top.

Queryhistory (1 / true to include per-chokepoint daily history[])

Sum of "ships in port" plus 24-hour arrivals and departures across the five Gulf ports adjacent to the strait. Coarser than AIS but survives AISStream outages. A live snapshot only, no daily history; for day-by-day transit counts use /api/v1/transits or the readable table at /how-many-ships-passed-through-the-strait-of-hormuz-today.

Sum of arrivals, departures, and "ships in port" across four South African ports (Cape Town, Durban, Port Elizabeth, Saldanha Bay). Tracks rerouting pressure as tankers avoid the Gulf.

Live counts at Fujairah, Sohar, Bandar Abbas, and Jebel Ali derived from AISStream positions inside a 10–12 km radius. Broken down by status (anchored, transiting) and vessel type.

Anchored-vessel count inside the Persian Gulf bounding box, hourly. Powers the homepage sparkline.

Querylimit (default 168 = 7 days hourly, max 720), since (ISO)

Hourly cross-tab of vessels in transit by vessel type (tanker, cargo, military, other). Pairs with /api/v1/stranded for a full picture of the strait's vessel mix over time. The response carries a methodology field covering how type is resolved and why the military count is a floor.

Querylimit (default 168 = 7 days hourly, max 720), since (ISO)

Free summary: the count of tankers gone dark inside the strait core area plus the 7-day baseline. Filters: type === tanker, totalSightings ≥ 50, last position in lat 24–28 / lng 55–58, last seen 3–24 hours ago. The per-vessel dark-fleet identities are in the premium vessel-intelligence API.

Free summary: the count of vessels visible on AIS in the Persian Gulf window whose identity matches an OFAC SDN entry (IMO / normalised-name join; false positives possible). The per-vessel manifest with sanction programs, flag, and call sign is in the premium vessel-intelligence API.

Free summary: how many vessels the scraper has observed in the last 3 hours across the Gulf and Cape routes, broken down by corridor and ship type. The per-vessel manifest with identities is in the premium vessel-intelligence API. ?flagged=1 counts the OFAC-SDN-matched subset.

Queryflagged (1 / true for OFAC-matched only), region (hormuz | cape)

Multiple over the peace-baseline VLCC premium, the current premium band in USD per voyage, and the list of P&I clubs and war-risk underwriters that have publicly withdrawn cover, imposed quotas, or refused renewals.

curl https://straits.live/api/v1/insurance

{
  "asOf": "2026-06-10T17:23:00Z",
  "methodology": "War-risk insurance multiple compares …",
  "insurance": {
    "multiple": 8,
    "vlccPremiumLow": 125000,
    "vlccPremiumHigh": 2500000,
    "withdrawnClubs": ["Gard", "Skuld", "North Standard", …],
    "sourceName": "Lloyd's Joint War Committee"
  }
}

EIA/IEA shares of global seaborne oil and LNG that transit the strait, a curated estimate of the daily economic cost, the most-affected importing economies, and the extra voyage days of the Cape reroute.

Marine war-risk high-risk-areas designations as published in the industry circular, plus a flag noting whether the latest revision mentions the Arabian Gulf. Drives war-risk premium loads at most London-market underwriters.

Top global container carriers (ranked by TEU capacity) and their current posture: suspended, rerouting, limited, or transiting. Includes vessels-trapped count, combined trapped-TEU capacity, and the per-carrier surcharge in USD per TEU. ≥5 carriers suspended or rerouting drives the dashboard's "effectively closed" verdict.

curl https://straits.live/api/v1/carriers

{
  "asOf": "2026-06-10T17:01:00Z",
  "count": 9,
  "carriers": [
    { "id": "msc", "carrier": "MSC", "rank": 1, "status": "rerouting",
      "surchargeUsdPerTeu": 1200, "vesselsTrapped": 15, "trappedTeu": 109000,
      "notes": "…", "sourceName": "MSC · Newsroom", "sourceUrl": "https://…" }
  ]
}

Petroline (Saudi Arabia → Yanbu) and Habshan-Fujairah (UAE → Gulf of Oman) are the main lines that move crude out of the Gulf without transiting Hormuz. Each row carries nameplate capacity in BPD and current utilisation percent.

Sell/buy rates in both Toman (1 Toman = 10 Rial) and Rial, plus 24-hour and 7-day percentage deltas off the midRial.

JSON archive of every brief written by the dailyBrief Cloud Function, keyed by UTC date. Each brief carries 3–6 bullets, a short summary, the day's Brent price plus 24-hour delta, and the day's transit count.

Querydate (YYYY-MM-DD for a single brief; 404 if missing), limit (default 30, max 120)

Bare-minimum payload polled by the homepage ticker every 60 seconds: Brent price, 24-hour change, transit and stranded counts, plus a verifiedAt anchor.

Compares the current state to a caller-provided anchor timestamp. Returns a material flag once any of: ≥24h elapsed, |Brent %| ≥ 1, ≥1 event, ≥1 carrier posture change, |transit delta| ≥ 3, or |stranded delta| ≥ 5.

Queryat (required ISO timestamp)

Backed by EIA Weekly Petroleum Status Report. Carries the 4-week change so spike-vs-baseline reads correctly.

Cushing, Oklahoma is the WTI delivery hub. Inventory swings here track the North-American crude balance independent of the Gulf-Coast / SPR picture; pairs with the Brent–WTI spread to indicate whether disruption is global or American-specific.

Indexed strikes, ship incidents, closures, and negotiations. Mirrors the curated Firestore record so consumers see the same source attribution as the homepage timeline. Companion to /data/events.csv and /feed.xml.

Querysince (ISO), type (strike | ship_incident | closure | negotiation), limit (default 50, max 200)

curl 'https://straits.live/api/v1/events?type=strike&limit=2'

{
  "asOf": "2026-05-27T14:30:00Z",
  "events": [
    { "id": "ev_2026-05-26_…", "type": "strike", "severity": "high",
      "occurredAt": "2026-05-26T11:20:00Z",
      "title": "Strike reported on Bandar Abbas refinery",
      "sourceName": "Reuters", "sourceUrl": "https://…" }
  ]
}

The live-AIS vessel manifest (MMSI-keyed, with a best-effort flag derived from the MMSI MID), the OFAC-sanctioned vessels currently in the Persian Gulf with program detail, per-vessel risk bands, latest raw AIS positions, the AIS-dark vessel list, and OFAC + UK sanctions reference-list sizes. Per-IMO multi-body sanction detail is in the single-vessel dossier.

Feeds: stranded and ais-gaps (hourly, up to a full year; the free windows stop at 30 days and none), index-5min (both Hormuz indices at 5-minute cadence with the pre-rails weighted average, ?days= up to 30), and transits (complete daily PortWatch history, enriched per day with the trailing 7-day moving average, deviation from the pre-crisis baseline, and headroom to the reopening-resolution threshold — the analytics the free raw CSV omits). One contract for all four series.

The entire dashboard state in a single response: verdict, oil, transits, insurance, carriers, pipelines, ports, events, prediction markets, both indices with component audit, and the full daily brief.

The AI-assisted situation brief as structured JSON: prose summary, bullets, and the day’s key figures, by date or latest, with archive access. The prose itself is free on /report; this is the stable machine contract.

One vessel by IMO: the unified multi-body sanctions view (every body that lists it — US OFAC and the UK/FCDO list — with the UK row adding owner/operator, flag, tonnage, ship type, year built, and Date Designated), merged identity, per-vessel risk band, and dark-activity (AIS-gap) record. Resolves for IMOs listed by OFAC or the UK, or with a dark-activity record.

Every requested series (index-5min, stranded, ais-gaps, transits) at full retained history in one archive, as JSON or multi-section CSV, with the transit series carrying the same per-day analytics (7-day MA, baseline deviation, reopening-threshold headroom) as the per-feed history call. ?feeds= to select, ?format=csv for the download. The read-heavy one-shot alternative to paging the per-feed history endpoint.

POST to buy a short-lived signed token, then open a Server-Sent Events connection at /api/premium/stream?token= to receive ticks, Hormuz Index moves, and events live instead of polling. One payment buys one bounded streaming window.

POST a target URL to receive a signed webhook whenever the verdict flips, a Hormuz Index band crosses up, or a monitored threshold breaches. One payment funds 30 days or 100 deliveries, whichever comes first.

The flag states of the live-AIS Persian Gulf vessel population ranked by vessel count, each with a per-flag sanctioned tally, plus distinct-flag count and sanctioned share. Flags are derived best-effort from the MMSI MID (ITU-T M.585) and the payload is quality-gated on live AIS. Operators and inbound/outbound direction are omitted, not faked: no operator field is stored and per-vessel transit direction is not tracked.

The live-AIS Persian Gulf vessel population as one ranked, compliance-grade screen, worst-first. Every hull carries its risk band and the typed reasons behind it (ofac_sdn, ais_dark, foc_tanker, imo_spoofed) plus which sanctions bodies list it (US OFAC and/or UK/FCDO). A transparent rules engine, not ML, fusing OFAC + UK sanctions, live AIS, AIS-dark gaps, and spoofed-IMO detection that the flag rollup only aggregates and the single-vessel dossier resolves one IMO at a time. counts cover the whole population; the rows are the flagged hulls (high + moderate) by default, ?all=1 adds the cleared low band. Quality-gated on live AIS.

Current VLSFO, IFO380, and MGO delivered bunker prices ($/tonne) for Fujairah, benchmarked against Singapore and Rotterdam, plus the derived Fujairah premium over each hub. Fujairah is the world’s #2-3 bunkering hub, just outside the strait and the physical fueling alternative when transit is disrupted, so its spread over the global benchmarks is a physical-commodity read on Hormuz stress that the Brent and insurance signals do not capture. Current snapshot, refreshed every 6 hours.

A live modeled war-risk insurance multiple (Nx over the peace baseline, on the standard 1x to 16x scale) for moving a tanker through the strait, recomputed every 5 minutes from throughput deviation (IMF PortWatch), the escalation forecast (Polymarket, Kalshi, Manifold, Brent-WTI spread), crude implied volatility (OVX), and event pressure (GDELT, PGSA). The insurance market’s own figure is deliberately kept out of the model, so the number is an independent read; the standing Lloyd’s Joint War Committee multiple is carried alongside as a static reference (it is set manually and rarely changes), not as a live comparator. Also returns a modeled VLCC war-premium band and a confidence that degrades when driver feeds are stale or escalation-market volume is thin. A modeled, AI-assisted situational-awareness indicator, not an insurance quote.