← Back to dashboard

UKOilWatch 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

# Current UK fuel reserves and days of cover
curl https://ukoilwatch.com/api/v1/stocks

# Current Brent crude price
curl https://ukoilwatch.com/api/v1/brent

# Index of all available endpoints
curl https://ukoilwatch.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: DESNZ Energy Trends Table 3.11

UK fuel reserve levels and days-of-supply by fuel

/api/v1/pricesSource: DESNZ Weekly Road Fuel Prices (CMA scheme)

Weekly UK pump prices for petrol and diesel

/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/bunkerSource: Derived from Brent

Marine bunker fuel price estimates (VLSFO / MGO) at Rotterdam, Fujairah, Singapore

/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: DESNZ Energy Trends Table 3.11

26-month UK stocks history (days of cover by fuel)

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

US MARAD maritime security advisories (filtered for UK 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 (sanctions, Russian exports, Hormuz, LNG)

Usage

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

Attribution requested. Cite as "UKOilWatch" with a link to ukoilwatch.com. Every payload also includes the underlying institutional source (DESNZ, EIA, etc.) — 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 (and after key official releases — DESNZ weekly prices on Tuesdays, EIA on Wednesdays). The API serves the latest committed file at each request, with CDN caching of up to 5 minutes.

Also available