{"uid":"cap_l-EWtku1YYR7E-TmOliAh","slug":"strait-of-hormuz-flag-rollup-b5fd2aab","name":"Strait of Hormuz Flag Rollup","description":"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.","url":"https://straits.live/api/premium/hormuz/flags","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VfTVReS8u7YOUHGMy0a8n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:15.256Z","isFirstParty":false}