Everything on this site, as structured data — priced per call, paid in USDC via x402. No accounts, no API keys, no subscription. An agent (or a person) requests a URL, gets a 402 Payment Required, pays, gets the data.
https://api.global-energy-flow.com · Protocol: x402 v2, USDC on Base · Auth: none requiredEvery dataset below has a free path in first: the full catalog is free to fetch, and each paid dataset has a free, truncated, 24-hours-delayed preview so you can evaluate quality before spending anything.
| Endpoint | Price | What it returns |
|---|---|---|
| GET /api/v1/index | Free | Machine-readable catalog of every endpoint on this API — the same data as this page, in JSON. Fetch this first. |
| GET /.well-known/x402 | Free | Bazaar-convention discovery manifest listing every paid endpoint, its price and network. |
| GET /api/v1/preview/:dataset | Free | One truncated, 24h-delayed record for hormuz, alerts, or risk-summary — see the real shape of the data before paying. |
The highest-value tier: not raw numbers, but GEF's own synthesis — "is the strait open right now," "how does today's disruption propagate through the rest of the system."
| Endpoint | Price | Description | Updates |
|---|---|---|---|
| GET /api/v1/chokepoints/hormuz | $0.02 | Single verdict: strait status, day count, latest events, toll status. | Multiple times daily during active crises; at least daily otherwise. |
| GET /api/v1/risk/summary | $0.05 | The day's cross-system connection as structured JSON — GEF's highest-value editorial synthesis. | Daily. |
| GET /api/v1/alerts | $0.01 | All currently active shortage/disruption pins worldwide, as structured events. | Daily, more often during acute escalation. |
| GET /api/v1/shortages/:country | $0.005 | Current status snapshot for one country. | Daily. |
| Endpoint | Price | Description | Updates |
|---|---|---|---|
| GET /api/v1/fuel-prices/:country | $0.001 | Current petrol/diesel status for one country. | Daily. |
| GET /api/v1/storage/gas/eu | $0.002 | Current EU gas storage % plus GEF's trajectory verdict vs. the seasonal target. | Daily (GIE AGSI+ publishes daily). |
| GET /api/v1/storage/oil/us | $0.002 | Latest EIA snapshot (crude, SPR, gasoline/distillate, week-over-week change) plus GEF's one-line read. | Weekly (EIA WPSR, Wednesdays). |
Every response shares the same envelope: your data under data, plus a meta block with the timestamp, source, and license.
{
"data": {
"status": "critical",
"day_count": 139,
"transits_per_day": null,
"latest_events": [
{
"date": "2026-07-16",
"summary": "US blockade disables first vessel under reinstated blockade."
}
],
"toll_pct": 0,
"updated_at": "2026-07-17T00:00:00Z"
},
"meta": {
"timestamp": "2026-07-17T08:12:00Z",
"source": "Global Energy Flow — Hormuz chokepoint desk",
"license": "Global Energy Flow — licensed for the requesting agent/application only; no redistribution or resale."
}
}Standard x402: call an endpoint, get back 402 Payment Required with payment terms in the response. Your x402-aware HTTP client signs a USDC payment and retries with a PAYMENT-SIGNATURE header. No account creation, no API key issuance, no rate-limit tiers to negotiate — the price is the access control.
Not sure where to start integrating x402 into your own agent or app? x402.org documents the protocol and lists client libraries.
Every figure on this API traces back to a named primary source — EIA, GIE AGSI+, UKMTO, Reuters, and GEF's own operator AIS vessel-tracking audit — the same sourcing discipline behind the human-facing dashboard and methodology page. Numbers that GEF hasn't independently re-verified in a given cycle are labeled as such rather than silently repeated. Responses are licensed for the requesting agent or application only — no redistribution or resale.