hormuz-strait
Check the current status of the Strait of Hormuz — shipping transit data, oil price impact, stranded vessels, insurance risk levels, diplomatic developments, and global trade impact. Use this skill whenever the user asks about the Strait of Hormuz, Hormuz chokepoint, Persian Gulf shipping risk, oil transit disruption, war risk premium in the Gulf, Middle East shipping routes, tanker traffic through Hormuz, oil supply chain risk, or geopolitical risk affecting energy markets. Triggers include: "Hormuz status", "Strait of Hormuz", "is Hormuz open", "shipping through the Gulf", "oil chokepoint", "Persian Gulf tanker traffic", "war risk premium", "Hormuz crisis", "energy supply chain risk", "oil transit disruption", "Middle East shipping", any mention of Hormuz or Persian Gulf in context of oil, shipping, or geopolitical risk.
Author
Category
Finance AnalysisInstall
Download and extract to your skills directory
Copy command and send to OpenClaw for auto-install:
Hormuz Strait Monitor Skill
Fetches real-time status of the Strait of Hormuz from the Hormuz Strait Monitor dashboard API. Covers shipping transits, oil prices, stranded vessels, insurance risk, diplomatic status, global trade impact, and crisis timeline.
This skill is read-only. It fetches public dashboard data — no authentication required.
Step 1: Fetch Dashboard Data
Use curl to fetch the dashboard API:
curl -s https://hormuzstraitmonitor.com/api/dashboardParse the JSON response. The API returns { "success": true, "data": { ... }, "timestamp": "..." }.
If success is false or the request fails, inform the user the monitor is temporarily unavailable and suggest checking https://hormuzstraitmonitor.com directly.
Step 2: Identify What the User Needs
Match the user's request to the relevant data sections. If the user asks for a general status update, present all sections. If they ask about something specific, focus on the relevant section(s).
| User Request | Data Section | Key Fields |
|---|---|---|
| General status / "is Hormuz open?" | straitStatus | status, since, description |
| Ship traffic / transit count | shipCount | currentTransits, last24h, normalDaily, percentOfNormal |
| Oil price impact | oilPrice | brentPrice, change24h, changePercent24h, sparkline |
| Stranded / stuck vessels | strandedVessels | total, tankers, bulk, other, changeToday |
| Insurance / war risk | insurance | level, warRiskPercent, normalPercent, multiplier |
| Cargo throughput | throughput | todayDWT, averageDWT, percentOfNormal, last7Days |
| Diplomatic situation | diplomacy | status, headline, parties, summary |
| Global trade impact | globalTradeImpact | percentOfWorldOilAtRisk, estimatedDailyCostBillions, affectedRegions, lngImpact, alternativeRoutes, supplyChainImpact |
| Crisis timeline / events | crisisTimeline | events[] with date, type, title, description |
| Latest news | news | title, source, url, publishedAt, description |
Step 3: Present the Data
Format the results clearly for financial research. Adapt the presentation based on what the user asked for.
General status briefing (default)
When the user asks for a general update, present a concise briefing covering all key sections:
Formatting guidelines
percentOfNormal is below 80% or above 120%, call it outoilPrice.sparkline, describe the trend (rising, falling, stable) rather than listing raw numbersthroughput.last7Days, describe the trend directionlastUpdated timestamp so the user knows data freshnessRisk assessment
Based on the data, provide a brief risk assessment:
| Insurance Level | Interpretation |
|---|---|
normal | No elevated risk — shipping operating normally |
elevated | Some disruption concerns — monitor closely |
high | Significant risk — active disruption or credible threat |
critical | Severe disruption — major impact on global oil supply |
If the strait status is anything other than fully open, highlight:
Step 4: Respond to the User
lastUpdated timestamp)Reference Files
references/api_schema.md — Complete API response schema with field descriptions and data typesRead the reference file when you need exact field names or data type details.