himself65/finance-skills / plugins/data-providers/skills/hormuz-strait
hormuz-strait
VerifiedCheck the live status of the Strait of Hormuz from the Hormuz Strait Monitor dashboard: open, restricted, or closed status, tanker transits vs normal, stranded vessels, Brent price impact, war-risk insurance levels, cargo throughput, tanker freight rates, diplomatic developments, and global trade impact. Use this skill whenever the user asks about the Strait of Hormuz or the Persian Gulf in the context of oil, shipping, or geopolitical risk — whether Hormuz is open, chokepoint or transit disruption, Gulf tanker traffic, war-risk premiums, Middle East shipping routes, or energy supply-chain risk.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.1 KB |
| SKILL.md | skill md | 6.0 KB |
| references/api_schema.md | markdown | 6.6 KB |
references/api_schema.md
View on GitHub# Hormuz Strait Monitor — Dashboard API Schema
**Endpoint:** `GET https://hormuzstraitmonitor.com/api/dashboard`
**Authentication:** None (public API)
**Response format:** JSON
---
## Top-level response
| Field | Type | Description |
|---|---|---|
| `success` | boolean | Whether the API call succeeded |
| `data` | object | Dashboard data (see sections below) |
| `timestamp` | string (ISO datetime) | Server response timestamp |
---
## `data.straitStatus`
Current operational status of the strait.
| Field | Type | Description |
|---|---|---|
| `status` | string | Current status enum (observed: "OPEN", "RESTRICTED", "CLOSED") |
| `since` | string (ISO date) | Date the current status began |
| `description` | string | Human-readable status description |
---
## `data.shipCount`
Ship transit statistics.
| Field | Type | Description |
|---|---|---|
| `currentTransits` | number | Ships currently transiting the strait |
| `last24h` | number | Total transits in the last 24 hours |
| `normalDaily` | number | Normal daily transit count (baseline) |
| `percentOfNormal` | number | Current traffic as percentage of normal |
---
## `data.oilPrice`
Brent crude oil price and recent movement.
| Field | Type | Description |
|---|---|---|
| `brentPrice` | number | Current Brent crude price (USD/barrel) |
| `change24h` | number | Absolute price change in last 24 hours |
| `changePercent24h` | number | Percentage price change in last 24 hours |
| `sparkline` | number[] | 24-hour price history (array of prices) |
---
## `data.strandedVessels`
Vessels unable to transit the strait.
| Field | Type | Description |
|---|---|---|
| `total` | number | Total stranded vessels |
| `tankers` | number | Stranded tanker vessels |
| `bulk` | number | Stranded bulk carriers |
| `other` | number | Other stranded vessels |
| `changeToday` | number | Change in stranded vessel count today |
---
## `data.insurance`
Marine insurance and war risk premium levels.
| Field | Type | Description |
|---|---|---|
| `level` | string | Risk level enum (observed: "NORMAL", "ELEVATED", "HIGH", "CRITICAL", "EXTREME") |
| `warRiskPercent` | number | Current war risk premium as percentage |
| `normalPercent` | number | Normal (baseline) insurance rate percentage |
| `multiplier` | number | Current rate as multiplier of normal rate |
---
## `data.throughput`
Cargo throughput in deadweight tonnage (DWT).
| Field | Type | Description |
|---|---|---|
| `todayDWT` | number | Today's cargo throughput in DWT |
| `averageDWT` | number | Average daily throughput in DWT |
| `percentOfNormal` | number | Today's throughput as percentage of average |
| `last7Days` | number[] | Daily DWT values for the last 7 days |
---
## `data.diplomacy`
Current diplomatic situation affecting the strait.
| Field | Type | Description |
|---|---|---|
| `status` | string | Diplomatic status enum (uppercase snake case; e.g., "TALKS_IN_PROGRESS") |
| `headline` | string | Current diplomatic headline |
| `date` | string (ISO date) | Date of the latest diplomatic development |
| `parties` | string[] | Parties involved |
| `summary` | string | Summary of the diplomatic situation |
---
## `data.globalTradeImpact`
Estimated impact on global trade if the strait is disrupted.
| Field | Type | Description |
|---|---|---|
| `percentOfWorldOilAtRisk` | number | Percentage of global oil supply at risk |
| `estimatedDailyCostBillions` | number | Estimated daily cost of disruption in billions USD |
| `affectedRegions` | object[] | List of affected regions (see below) |
| `lngImpact` | object | LNG-specific impact (see below) |
| `alternativeRoutes` | object[] | Available alternative shipping routes (see below) |
| `supplyChainImpact` | object | Broader supply chain impact (see below) |
### `affectedRegions[]`
| Field | Type | Description |
|---|---|---|
| `name` | string | Region name |
| `severity` | string | Impact severity enum (observed: "MODERATE", "HIGH", "CRITICAL") |
| `oilDependencyPercent` | number | Region's dependency on strait-transiting oil |
| `description` | string | Description of impact on this region |
### `lngImpact`
| Field | Type | Description |
|---|---|---|
| `percentOfWorldLngAtRisk` | number | Percentage of global LNG at risk |
| `estimatedLngDailyCostBillions` | number | Estimated daily LNG disruption cost (billions USD) |
| `topAffectedImporters` | string[] | Countries most affected by LNG disruption |
| `description` | string | Description of LNG impact |
### `alternativeRoutes[]`
| Field | Type | Description |
|---|---|---|
| `name` | string | Route name |
| `additionalDays` | number | Extra transit days vs. Hormuz route |
| `additionalCostPerVessel` | number | Extra cost per vessel (USD) |
| `currentUsageStatus` | string | Whether this route is currently in use |
### `supplyChainImpact`
| Field | Type | Description |
|---|---|---|
| `shippingRateIncreasePercent` | number | Percentage increase in shipping rates |
| `consumerPriceImpactPercent` | number | Estimated consumer price impact |
| `sprStatusDays` | number | Strategic Petroleum Reserve coverage in days |
| `keyDisruptions` | string[] | Key supply chain disruptions |
---
## `data.crisisTimeline`
Timeline of events related to the current situation.
### `events[]`
| Field | Type | Description |
|---|---|---|
| `date` | string (ISO date) | Event date |
| `type` | string | Event type enum (observed: "MILITARY", "DIPLOMATIC", "ESCALATION", "ECONOMIC") |
| `title` | string | Event title |
| `description` | string | Event description |
---
## `data.tankerRates`
VLCC tanker freight rate tracker for the Hormuz-adjacent benchmark route.
| Field | Type | Description |
|---|---|---|
| `currentRate` | number | Current freight rate on the benchmark route |
| `preCrisisRate` | number | Pre-crisis baseline rate on the same route |
| `changePercent` | number | Percentage change vs. the pre-crisis baseline |
| `route` | string | Benchmark route code (e.g., "AG-East (TD3C)") |
| `vesselType` | string | Vessel class (e.g., "VLCC") |
| `trend` | number[] | Recent rate history points (aligned with `unit`) |
| `unit` | string | Rate unit (e.g., "WS" for Worldscale, "USD/day" for time-charter equivalent) |
---
## `data.news`
Latest news articles related to the strait.
| Field | Type | Description |
|---|---|---|
| `title` | string | Article title |
| `source` | string | News source name |
| `url` | string | Link to the article |
| `publishedAt` | string (ISO datetime) | Publication timestamp |
| `description` | string | Article summary |
---
## `data.lastUpdated`
String (ISO datetime) — when the dashboard data was last updated. Appears directly on `data`, not as a nested object.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |