Open index data
The complete HMX-INDEX series is free to download and free to republish under CC BY 4.0. No API key, no registration, no rate limit worth mentioning. Currently 30 weekly observations, 2026-01-05 to 2026-07-27.
Endpoints
/api/hormuz-index/data.json
Current snapshot, full per-component breakdown, baseline values, correlation matrix and the complete weekly history.
curl https://mydatalabs.in/api/hormuz-index/data.json/api/hormuz-index/data.csv
Weekly history with raw component values, one row per week — ready for a spreadsheet or a dataframe.
curl -O https://mydatalabs.in/api/hormuz-index/data.csv/api/health
Liveness probe. Also reports whether scheduled writes are landing somewhere durable and how old the cached snapshot is.
JSON response shape
{
"ticker": "HMX-INDEX",
"index_name": "Hormuz Crisis Index",
"license": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/" },
"generated_at": "2026-07-26T04:00:00+00:00",
"current_snapshot": {
"week_start": "2026-07-27",
"score": 169.8,
"level_label": "Severe",
"level_status": "serious",
"degraded": true,
"stale_weight": 0.65
},
"baseline": { "window": "...", "values": { "brent": 65.0, ... } },
"scale": { "min": 100.0, "max": 200.0 },
"components": [
{
"key": "brent",
"label": "Brent Crude",
"weight": 0.3,
"unit": "$/bbl",
"current_value": 96.78,
"baseline_value": 65.0,
"cap_pct": 55,
"inverted": false,
"stress_score": 88.9,
"contribution": 26.67,
"source": "yfinance (BZ=F)",
"manual": false,
"update_cadence": "Daily (automatic)",
"last_updated": "2026-07-26",
"stale": false,
"carried_forward": false
}
],
"component_correlations": { "n": 29, "matrix": { ... } },
"history": [ { "week_start": "...", "score": 100.0, "raw_values": { ... } } ]
}Fields worth reading carefully
stale- The value could not be refreshed on schedule; the last known reading was carried forward. It is not reset to baseline.
carried_forward- The value was reused from a prior observation rather than fetched this run. Normal for the four manually-keyed components between weekly updates.
degraded- True when stale components account for 20% or more of index weight. Treat the composite as provisional when this is set.
stale_weight- Fraction of total index weight currently stale, 0 to 1.
Component correlation matrix
Pearson correlation between component series across 30 weekly observations. Published because Brent, TTF gas and VIX together carry 50% of index weight and tend to move together in an energy shock — the composite is less diversified than a seven-component structure suggests, and this is the size of that effect rather than a caveat to take on trust.
| Component | Brent Crude | Hormuz Transits (all commercial vessels) | War-Risk Insurance (per transit) | Tanker Freight (BDTI) | TTF European Gas | VIX Volatility Index | Cape of Good Hope Reroutes |
|---|---|---|---|---|---|---|---|
| Brent Crude | 1.00 | -0.96 | 0.95 | 0.97 | 0.92 | 0.88 | 0.97 |
| Hormuz Transits (all commercial vessels) | -0.96 | 1.00 | -0.89 | -0.96 | -0.83 | -0.89 | -0.96 |
| War-Risk Insurance (per transit) | 0.95 | -0.89 | 1.00 | 0.96 | 0.94 | 0.84 | 0.96 |
| Tanker Freight (BDTI) | 0.97 | -0.96 | 0.96 | 1.00 | 0.86 | 0.94 | 1.00 |
| TTF European Gas | 0.92 | -0.83 | 0.94 | 0.86 | 1.00 | 0.65 | 0.86 |
| VIX Volatility Index | 0.88 | -0.89 | 0.84 | 0.94 | 0.65 | 1.00 | 0.93 |
| Cape of Good Hope Reroutes | 0.97 | -0.96 | 0.96 | 1.00 | 0.86 | 0.93 | 1.00 |
How to cite
News and general prose
MyDataLabs Hormuz Crisis Index (HMX-INDEX), mydatalabs.in, week of 2026-07-27.BibTeX
@misc{mydatalabs_hmx_2026,
title = {Hormuz Crisis Index (HMX-INDEX)},
author = {MyDataLabs Intelligence Network},
year = {2026},
howpublished = {\url{https://mydatalabs.in/hormuz-index}},
note = {Accessed: 2026-07-27. Licensed CC BY 4.0.}
}Licence and fair use
Index data — scores, component values and history — is licensed CC BY 4.0: reuse it commercially or otherwise, with attribution to MyDataLabs and a link back.
Please cache rather than polling: the underlying values change at most daily, and the endpoints are served from cache with a one-hour revalidation window.
Not included in these endpoints: the vessel incident log shown on the dashboard is compiled separately from the index components and is not served by the API.