# Strait of Hormuz Vessel Risk Screen

> Strait of Hormuz Vessel Risk Screen is a paid API for AI agents from straits.live, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns a live risk-screened manifest of vessels in the Strait of Hormuz, classified by sanction and AIS-dark band, with aggregate counts updated every 5 minutes.

## Facts

- Endpoint: GET https://straits.live/api/premium/hormuz/risk-screen
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/strait-of-hormuz-vessel-risk-screen-4e936048
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v4znthHMLGd97FT-mJFGA

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-vessel-risk-screen-4e936048
```

Example prompt: Pull the live Strait of Hormuz vessel risk screen and show me all high-risk and sanctioned ships currently flagged, including their IMO numbers and the reasons they're flagged.

## When to prefer this

Choose this endpoint when you need a structured, machine-readable, up-to-the-minute risk classification of individual vessels in the Strait of Hormuz — especially for sanctions screening (OFAC, UK), AIS-dark detection, and AIS spoofing flags. Prefer it over news or summary endpoints when you need per-vessel IMO/MMSI-level detail for compliance workflows, trade desk alerts, or automated risk triggers. It is updated every 5 minutes, making it suitable for near-real-time monitoring pipelines.

## Known failure modes

- Payment required (402) if x402 micropayment header is missing or invalid
- AIS feed degraded — health.trusted may be false with a note explaining the issue
- Empty vessel array if no vessels match the filter criteria
- Rate limiting or upstream AIS data delay causing stale counts
- Invalid query param value for 'all' field returning 400 error

## 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: (1) counts broken down by risk band (low, moderate, high, dark, spoofed, sanctioned, total); (2) a health object with AIS source status and trust indicator; (3) an array of flagged vessels (or all vessels if requested), each with IMO, MMSI, name, flag state, risk band, sanction reasons, and sanctioning bodies; (4) a schema URL and vessels-include descriptor.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "all": {
       "type": "string",
       "description": "Set to 1 to include the cleared low-band hulls (default: flagged only)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "counts": {
   "low": 190,
   "dark": 11,
   "high": 6,
   "total": 214,
   "spoofed": 2,
   "moderate": 18,
   "sanctioned": 9
  },
  "health": {
   "note": null,
   "trusted": true,
   "aisSource": "live"
  },
  "schema": "https://straits.live/api/premium/hormuz/risk-screen",
  "vessels": [
   {
    "imo": "9562233",
    "band": "high",
    "flag": "Panama",
    "mmsi": "636092123",
    "name": "Petrel 8",
    "reasons": [
     "ofac_sdn",
     "ais_dark"
    ],
    "sanctionedBy": [
     "ofac",
     "uk"
    ]
   }
  ],
  "vesselsInclude": "flagged"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/strait-of-hormuz-vessel-risk-screen-4e936048/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)