{"uid":"cap_xSfTjX-Q1tlDetV71Dkk0","slug":"strait-of-hormuz-historical-feed-api-straits-live-388a202f","name":"Strait of Hormuz Historical Feed API (straits.live)","description":"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.","url":"https://straits.live/api/premium/history/%7Bfeed%7D","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"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_GmP9SQ4bjULFjSz95cu95","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 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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Energy trader tracking oil supply risk","prompt":"Get me the last 30 days of daily Strait of Hormuz transit data — I want to see how tanker numbers have been trending versus the baseline and whether we're getting any closer to the reopening threshold."},{"title":"Analyst investigating suspicious vessel behavior","prompt":"Pull the AIS gap history for the Strait of Hormuz — I need to see how many vessels have been going dark in the strait region and whether that's been increasing."},{"title":"Logistics team monitoring stranded cargo","prompt":"Fetch the stranded vessel count history from straits.live for the Hormuz crisis so I can report on how many ships have been stuck and how that number has changed over the past week."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:01.921Z","isFirstParty":false}