# Strait of Hormuz Flag Rollup

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

Returns a ranked breakdown of flag states for all live-AIS vessels in the Strait of Hormuz, including per-flag sanctioned vessel tallies and an overall sanctioned share metric.

## Facts

- Endpoint: GET https://straits.live/api/premium/hormuz/flags
- Price: $0.01/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-flag-rollup-b5fd2aab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l-EWtku1YYR7E-TmOliAh

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-flag-rollup-b5fd2aab
```

Example prompt: What's the current flag breakdown for vessels in the Strait of Hormuz — including how many are from sanctioned flags and what share of the total that represents?

## When to prefer this

Use this endpoint when you need a high-level, flag-aggregated view of Hormuz vessel traffic with sanctions exposure metrics — ideal for compliance screening, geopolitical risk dashboards, or sanctions monitoring workflows. Prefer over the per-vessel manifest endpoint when you need aggregate statistics rather than individual vessel details.

## Known failure modes

- No live AIS data available — quality gate fails if AIS feed is stale or offline
- Rate limit exceeded for the premium endpoint
- Payment not included or insufficient — x402 payment required at $0.01 USDC
- Empty result if no vessels are currently in the strait's AIS coverage zone

## How this service works

Strait of Hormuz flag rollup: the flag states of the live-AIS 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). Quality-gated on live AIS. Operators and inbound/outbound direction are omitted, not faked: no operator field is stored and transit direction is not tracked per vessel.

## Output

A ranked list of flag states by vessel count in the Strait of Hormuz, with each flag showing a sanctioned vessel tally, plus summary statistics including the total number of distinct flags and the overall sanctioned vessel share. Flags are derived from MMSI MID codes per ITU-T M.585.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "health": {
   "note": null,
   "trusted": true,
   "aisSource": "live"
  },
  "schema": "https://straits.live/api/premium/hormuz/flags",
  "top_flags": [
   {
    "code": "PA",
    "count": 41,
    "country": "Panama",
    "sanctioned_count": 2
   }
  ],
  "vessel_count": 214,
  "distinct_flags": 28,
  "sanctioned_count": 9,
  "sanctioned_share": 0.042
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/strait-of-hormuz-flag-rollup-b5fd2aab/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)