# Strait of Hormuz Historical Feed API (straits.live)

> Strait of Hormuz Historical Feed API (straits.live) is a paid API for AI agents from straits.live, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns time-series historical data for one of four Strait of Hormuz crisis feeds: 5-minute index snapshots, daily transit counts, stranded vessel counts, or AIS gap events.

## Facts

- Endpoint: GET https://straits.live/api/premium/history/%7Bfeed%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/strait-of-hormuz-historical-feed-api-straits-live-388a202f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xSfTjX-Q1tlDetV71Dkk0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability strait-of-hormuz-historical-feed-api-straits-live-388a202f
```

Example prompt: Pull the daily transit history for the Strait of Hormuz over the last 14 days from straits.live so I can see how ship counts have trended versus the 88-ship baseline and how close we are to the 60-ship reopening threshold.

## When to prefer this

Choose this endpoint when you need time-series historical data about the Strait of Hormuz crisis — specifically transit counts, tanker/cargo breakdowns, stranded vessel counts, or AIS anomaly gaps over days or weeks. Prefer it over the live snapshot endpoint when trend analysis or charting is the goal. Prefer the 'transits' feed for shipping/oil market analysis, 'ais-gaps' for maritime security or dark-vessel detection, and 'index-5min' for near-real-time granular monitoring over a short window.

## Known failure modes

- Invalid feed enum value returns an error — must be one of: index-5min, transits, stranded, ais-gaps
- days parameter out of range (outside 1-30) may return an error or be clamped
- days parameter supplied for non-index-5min feeds is likely ignored
- Payment not included or insufficient (x402 protocol) returns 402 Payment Required
- No data available for very recent windows if the feed has not yet been updated
- Rate limiting if called too frequently without proper payment

## How this service works

Is the Strait of Hormuz open? Effectively no, it is closed to commercial shipping as of 13 July 2026. 34 ships transited vs ~88/day normal. Brent $81.10. Updated every 5 minutes.

## Output

A JSON object containing the requested feed name, a baseline value (88 ships/day normal), a reopening threshold (60 ships/day), a count of data points, and an array of time-series records. Each record includes date, total transits (nTotal), cargo (nCargo) and tanker (nTanker) breakdown, 7-day moving average (ma7), deviation from baseline (baselineDelta), and headroom to the reopening threshold (thresholdHeadroom). Also references the schema URL for the specific feed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "feed": {
       "enum": [
        "index-5min",
        "transits",
        "stranded",
        "ais-gaps"
       ],
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "days": {
       "type": "number",
       "description": "index-5min only: window in days, 1-30 (default 7)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "feed": "transits",
  "count": 480,
  "points": [
   {
    "ma7": 2.4,
    "date": "2026-07-07",
    "nCargo": 1,
    "nTotal": 2,
    "nTanker": 1,
    "baselineDelta": -86,
    "thresholdHeadroom": -57.6
   }
  ],
  "schema": "https://straits.live/api/premium/history/transits",
  "baseline": 88,
  "reopeningThreshold": 60
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/strait-of-hormuz-historical-feed-api-straits-live-388a202f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from straits.live](https://www.zero.xyz/host/straits.live/llms.txt)