Hormuz Strait

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/dashboard

Parse 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).

---

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:

1. Strait Status — lead with the current status (e.g., "OPEN", "RESTRICTED", "CLOSED"), how long it's been in that state, and the description 2. Ship Traffic — current transits, last 24h count, and percent of normal 3. Oil Price — Brent price with 24h change 4. Stranded Vessels — total count broken down by type, with today's change 5. Insurance Risk — risk level, war risk premium percentage, and multiplier vs. normal 6. Cargo Throughput — today's DWT vs. average, percent of normal 7. Diplomatic Status — current status, headline, and brief summary 8. Global Trade Impact — percent of world oil at risk, estimated daily cost, and top affected regions 9. Tanker Freight Rates — current VLCC rate on the benchmark route vs. pre-crisis baseline, with trend direction

Formatting guidelines

• Use tables for structured data (vessel counts, affected regions, alternative routes)
• Highlight abnormal values — if percentOfNormal is below 80% or above 120%, call it out
• For oilPrice.sparkline, describe the trend (rising, falling, stable) rather than listing raw numbers
• For throughput.last7Days, describe the trend direction
• Show lastUpdated timestamp so the user knows data freshness
• For news items, include the source and link
• For crisis timeline events, present chronologically with event type labels

Risk assessment

Based on the data, provide a brief risk assessment:

Values are returned uppercase.

If the strait status is anything other than fully open, highlight:

• The estimated daily cost to global trade
• Which regions are most affected and their oil dependency
• Available alternative routes with additional transit days and cost
• LNG impact if applicable
• SPR (Strategic Petroleum Reserve) status in days

---

Step 4: Respond to the User

• Lead with the most important information: strait status and any active disruption
• Include data freshness (lastUpdated timestamp)
• If the situation is elevated or worse, proactively include the global trade impact summary
• Keep the response concise for routine "all clear" statuses; expand for active incidents
• Add a disclaimer: data is sourced from Hormuz Strait Monitor and may have delays

---

Reference Files

• references/api_schema.md — Complete API response schema with field descriptions and data types

Read the reference file when you need exact field names or data type details.

hormuz-strait

Real-time Strait of Hormuz monitoring for energy market and geopolitical risk research via the Hormuz Strait Monitor dashboard API.

What it does

Fetches the current status of the Strait of Hormuz and presents a risk briefing covering:

• Strait status — open, restricted, or closed, with duration and description
• Ship traffic — current transits, 24h count, and percent of normal baseline
• Oil price impact — Brent crude price with 24h change and trend
• Stranded vessels — count by type (tankers, bulk, other) with daily change
• Insurance risk — war risk premium level, percentage, and multiplier vs. normal
• Cargo throughput — daily DWT vs. average with 7-day trend
• Diplomatic status — current situation, parties involved, and headline
• Global trade impact — percent of world oil/LNG at risk, daily cost, affected regions, alternative routes, and supply chain disruption
• Crisis timeline — chronological events (military, diplomatic, economic)
• Tanker freight rates — VLCC benchmark rate vs. pre-crisis baseline with trend
• Latest news — recent articles with sources and links

This skill is read-only. No authentication required — uses the public dashboard API.

Triggers

• "Hormuz status", "Strait of Hormuz", "is Hormuz open"
• "shipping through the Gulf", "Persian Gulf tanker traffic"
• "oil chokepoint", "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

Platform

Works on all platforms (Claude Code, Claude.ai, and other agents). Only requires curl for the API call.

Setup

# As a plugin (recommended — installs all skills)
npx plugins add himself65/finance-skills --plugin finance-data-providers

# Or install just this skill
npx skills add himself65/finance-skills --skill hormuz-strait

See the main README for more installation options.

Reference files

• references/api_schema.md — Complete API response schema with field descriptions and data types

Hormuz Strait Monitor — Dashboard API Schema

Endpoint: GET https://hormuzstraitmonitor.com/api/dashboard

Authentication: None (public API)

Response format: JSON

---

Top-level response

---

data.straitStatus

Current operational status of the strait.

---

data.shipCount

Ship transit statistics.

---

data.oilPrice

Brent crude oil price and recent movement.

---

data.strandedVessels

Vessels unable to transit the strait.

---

data.insurance

Marine insurance and war risk premium levels.

---

data.throughput

Cargo throughput in deadweight tonnage (DWT).

---

data.diplomacy

Current diplomatic situation affecting the strait.

---

data.globalTradeImpact

Estimated impact on global trade if the strait is disrupted.

affectedRegions[]

lngImpact

alternativeRoutes[]

supplyChainImpact

---

data.crisisTimeline

Timeline of events related to the current situation.

events[]

---

data.tankerRates

VLCC tanker freight rate tracker for the Hormuz-adjacent benchmark route.

---

data.news

Latest news articles related to the strait.

---

data.lastUpdated

String (ISO datetime) — when the dashboard data was last updated. Appears directly on data, not as a nested object.