← Back to dashboard

EuroOilWatch Public API

Free, read-only JSON access to the same data that powers the dashboard. CORS-enabled, no authentication, no key required. Built so journalists, analysts, researchers, and LLM agents can cite the underlying numbers directly rather than scraping the rendered page.

Quick start

# EU-27 country fuel reserves and days of cover
curl https://eurooilwatch.com/api/v1/stocks

# TTF + Henry Hub gas prices + AGSI storage
curl https://eurooilwatch.com/api/v1/gas

# Index of all available endpoints
curl https://eurooilwatch.com/api/v1

All responses are application/json; charset=utf-8. Cache headers are set to s-maxage=300, stale-while-revalidate=3600 so the CDN serves quickly while keeping data fresh.

Available endpoints

/api/v1/stocksSource: Eurostat (nrg_stk_oilm)

EU-27 country fuel reserve levels and days-of-supply

/api/v1/pricesSource: EC Weekly Oil Bulletin

EU-27 weekly consumer fuel prices

/api/v1/prices-historySource: European Commission

EU average petrol and diesel price history

/api/v1/brentSource: Stooq (cb.f)

Current Brent crude price (front-month futures)

/api/v1/brent-historySource: Stooq

52-week Brent crude price history (weekly close)

/api/v1/brent-eia-dailySource: U.S. EIA (RBRTE)

EIA Europe Brent Spot Price FOB daily series, since 20 May 1987

/api/v1/gasSource: Yahoo Finance + AGSI/GIE

Dutch TTF + US Henry Hub gas prices + AGSI EU storage levels

/api/v1/ara-stocksSource: Argus Media (syndicating Insights Global)

ARA hub weekly product stocks (jet, gasoline, naphtha, gasoil)

/api/v1/bunkerSource: Derived from Brent

Marine bunker fuel price estimates (VLSFO / MGO)

/api/v1/bunker-historySource: Derived from Brent

Rolling history of bunker fuel estimates

/api/v1/sea-stateSource: Open-Meteo Marine + Forecast

Live wave height + wind at key oil-shipping chokepoints

/api/v1/historySource: Eurostat

18-month EU stocks history (days of cover by fuel)

/api/v1/marad-advisoriesSource: maritime.dot.gov

US MARAD maritime security advisories (filtered for European supply relevance)

/api/v1/centcom-advisoriesSource: U.S. Central Command via DVIDS

CENTCOM Middle East maritime advisories

/api/v1/crea-feedSource: CREA

Energy and clean air research feed

Usage

Free. No key, no rate limits beyond reasonable use. CORS is open (Access-Control-Allow-Origin: *).

Attribution requested. Cite as "EuroOilWatch" with a link to eurooilwatch.com. Every payload also includes the underlying institutional source — please also credit those where appropriate.

No warranty. Data is provided as-is from public official sources. We do not guarantee accuracy, completeness or fitness for any specific purpose. Do not use for trading or safety-critical decisions without independent verification.

Update cadence. Underlying data files refresh daily via automated workflow at 05:00 UTC, plus extra runs after key official releases (EC Oil Bulletin Thursdays, EIA Wednesdays). The API serves the latest committed file at each request, with CDN caching of up to 5 minutes.

Also available