Developer Documentation · API v2.1
Hormuz Live API
Real-time JSON API for Strait of Hormuz risk scores, tanker traffic, oil prices, and crisis status. Free tier available — no credit card required.
Base URL
https://hormuzmonitor.com/wp-json/hlapi/v2
Pricing
API Plans
Free
Explorer
$0/month
- 60 requests / hour
- /risk — composite score
- /traffic — transit counts
- /prices — 15min delayed
- /crisis — status & events
- /bypass — pipeline status
- /dependency — limited fields
- /incidents & /vessels
- Webhooks & alerts
- Historical data
Most popular
Professional
$49.00/month
- 5,000 requests / hour
- All core endpoints
- /incidents — full feed
- /vessels — AIS positions
- /risk/history — 90 days
- POST /webhooks — alerts
- Real-time price data
- All dependency fields
- WebSocket stream
- Custom SLA
Enterprise
Institutional
Custom
- Unlimited requests
- WebSocket real-time stream
- Full AIS positions
- Full historical archive
- Custom risk parameters
- 99.9% SLA
- Private webhook endpoints
- White-label embed
- Dedicated analyst support
- Invoice billing available
Endpoints
API Reference
GET
/risk
FREE
Composite Hormuz risk index (0–10) with 5 dimensions
GET
/traffic
FREE
Daily tanker transits, stranded vessels, dark ships
GET
/prices
FREE
Oil benchmarks (Brent, WTI, LNG) and tanker rates
GET
/crisis
FREE
Current crisis status, key developments, metrics
GET
/bypass
FREE
Pipeline bypass capacity and utilisation
GET
/dependency
FREE
Country Hormuz Dependency Scores (add ?country=JP)
GET
/risk/history
PRO
Historical daily risk scores (add ?days=30)
GET
/incidents
PRO
Maritime incident feed with type filtering
POST
/webhooks
PRO
Register threshold alert webhooks
Playground
Live API Tester
Test endpoints directly. Enter your API key or leave blank for the demo.
// Click RUN to execute a request
Get Started
Get Your Free API Key
No credit card required. Free tier: 60 requests/hour, core endpoints included.
Upgrade to Pro
Get Your Pro API Key
5,000 requests/hour · All endpoints · Webhooks · Real-time data. Secure payment via PayPal — your key is issued and emailed immediately after payment.
Authentication
Authentication
Pass your API key in the X-API-Key header on every request.
cURL
curl https://hormuzmonitor.com/wp-json/hlapi/v2/risk \ -H "X-API-Key: hm_live_YOUR_KEY_HERE" \ -H "Accept: application/json"