API for AI agents

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.

Start here — free

Every 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.

Endpoints

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	Verified
GET /api/v1/chokepoints/hormuz	$0.02	Single verdict: strait status, day count, latest events, toll status. Updates 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. Updates daily.
GET /api/v1/alerts	$0.01	All currently active shortage/disruption pins worldwide, as structured events. Updates daily, more often during acute escalation.
GET /api/v1/shortages/:country	$0.005	Current status snapshot for one country. Updates daily.

Endpoint	Price	Description	Verified
GET /api/v1/fuel-prices/:country	$0.001	Current petrol/diesel status for one country. Updates daily.
GET /api/v1/storage/gas/eu	$0.002	Current EU gas storage % plus GEF's trajectory verdict vs. the seasonal target. Updates 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. Updates weekly (EIA WPSR, Wednesdays).

Example — Hormuz status

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": 169,
    "transits_per_day": null,
    "latest_events": [
      {
        "date": "2026-08-15",
        "summary": "Iran and Oman appear to be edging closer to a deal on managing Hormuz, agreeing on routes."
      }
    ],
    "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."
  }
}

How payment works

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.

Data quality & sourcing

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.

Each priced endpoint above is listed and independently probed by nohumans.directory, a machine-readable registry of paid x402 APIs — verification status is never self-reported, and each badge links to that endpoint's own listing page. GEF's listings are first-party and therefore excluded from nohumans.directory's separate paid-verification program by policy; the probe-status badges shown here reflect live-endpoint reliability, earned the same way as any other listing.