← Back to dashboard

AmericasOilWatch 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 WTI crude price
curl https://americasoilwatch.com/api/v1/wti

# US weekly petroleum stocks (crude, gasoline, distillates, SPR, production)
curl https://americasoilwatch.com/api/v1/us-stocks

# Index of all available endpoints
curl https://americasoilwatch.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/wtiSource: Stooq cl.f → EIA daily fallback

Current WTI crude price (Cushing, OK)

/api/v1/wti-historySource: Stooq / EIA RWTC

WTI price history

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

Current Brent crude price (front-month futures)

/api/v1/brent-historySource: Stooq

Brent price history

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

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

/api/v1/us-stocksSource: U.S. EIA Weekly Petroleum Status Report

US commercial crude, gasoline, distillate, SPR stocks and production

/api/v1/us-pricesSource: U.S. EIA

US weekly retail gasoline and diesel prices

/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/marad-advisoriesSource: maritime.dot.gov

US MARAD maritime security advisories

/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

/api/v1/news-feedSource: OilPrice.com, Rigzone, Offshore Technology RSS

Aggregated oil and energy news headlines

/api/v1/opecSource: U.S. EIA International + OPEC+ JMMC schedule

OPEC+ member production vs Declaration of Cooperation quotas

Usage

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

Attribution requested. Cite as "AmericasOilWatch" with a link to americasoilwatch.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 06:00 UTC, plus extra runs after the EIA weekly stocks release (Wednesdays). The API serves the latest committed file at each request, with CDN caching of up to 5 minutes.

Also available