Changelog

All notable changes to the OilPriceAPI are documented here.

The format is based on Keep a Changelog.

July 2026

Added

Fuel Surcharge API reference for carrier-published LTL and parcel surcharge schedules:
- GET /v1/fuel-surcharge - latest LTL surcharges by covered carrier
- GET /v1/fuel-surcharge/:carrier/latest and /history - one LTL carrier
- GET /v1/fuel-surcharge/parcel - latest parcel surcharges grouped by carrier and service level
- GET /v1/fuel-surcharge/parcel/:carrier/latest and /history - one parcel carrier/service level
API reference coverage for spreads, market indicators, bunker and maritime fuels, gas/LNG futures, UK carbon futures, webhooks, alerts, account status, API keys, subscriptions, organizations, and price utility endpoints.
Data-rights guidance for internal use, public display, redistribution, and downstream productization review.
Documentation guardrails for unsupported market-data claims and phantom endpoint drift.

Changed

Replaced broad "real-time" claims with source timestamp and documented update-cadence language where users need to evaluate freshness.
Removed phantom /v1/drilling/* paths and corrected marine fuel paths in the published OpenAPI file.
Standardized data-source labels. The source / data_source fields in API responses now report a consistent value for non-government data: series drawn from published market reporting return market_reporting, while government-sourced series continue to name their agency (for example EIA, OPEC). This aligns our responses with our Data Provenance & Rights policy: OilPriceAPI is a data collection and delivery service, and we are not affiliated with or a licensed distributor of any exchange or price-reporting agency. If your integration branches on the source string, update it to treat market_reporting as the label for non-government sources. The underlying prices and endpoints are unchanged.

June 2026

Added

AI-agent endpoints for the OilPriceAPI MCP server:
- GET /v1/market-brief - multi-commodity snapshot with 24h changes, 1-month forecasts, and an optional plain-English narrative (1 request per call)
- /v1/subscriptions - persistent recurring "watches" with a poll-based event model (GET /v1/subscriptions/events, which does not count against the request quota)
Agent Subscriptions with MCP recipe documenting opa_get_market_brief, opa_create_price_subscription, and opa_get_subscription_events
Per-tier plan gating for codes-per-brief, watch count, and snapshot interval (Free included; full feature on Professional and Scale)
Well Production Data — four-state launch (TX, AK, NM, ND) with US national monthly rollup:
- GET /v1/well-production/ — coverage and package summary
- GET /v1/well-production/states — supported states with metadata
- GET /v1/well-production/states/:code — state production history (well-level monthly)
- GET /v1/well-production/wells/:api — individual well production by API number
- GET /v1/well-production/top-producers — top producing wells by state
- GET /v1/well-production/cycle-time — permit-to-first-production cycle time
- GET /v1/well-production/cycle-time/cohorts — cycle time by vintage cohort
- Sources: TX RRC, NM OCD, ND NDIC, AOGCC. Additional states are in progress — see the Well Production reference for current coverage.
- National rollup (US/state_well_rollup) derives monthly totals from all collected well-level state rows.

May 2026

Added

ICE JKM LNG futures — GET /v1/futures/lng-jkm (with /historical, /curve, /ohlc, /intraday, /spreads)
UK carbon (UKA) futures — GET /v1/futures/uk-carbon (with /historical)
Excel API gateway — GET /v1/excel/run and GET /v1/prices/excel-latest backing the Excel add-in
Developer plans now allow up to 3 API keys
Futures responses expose front-month contract-selection semantics

April 2026

Added

Calculated Metrics API — GET /v1/spreads/*: crack spreads, basis spreads, curve structure, refinery margin, and physical (spot-vs-futures) premium, each with /historical and /all variants
Market intelligence — market annotations, CFTC positioning, and storage analytics
Well Production Data — TX RRC well-level scraper and Enterprise API (foundation for the June four-state launch)
21 new physical commodity spot prices (EIA, EEX, NGI, ACER sources)
Macro economic indicators (FRED integration) and an economic release calendar
GET /v1/futures/ice-brent now returns the front-month contract and its codes
/v1/prices auto-downsamples long windows for intraday commodity codes

December 2025

Added

7-day free trial with 10,000 requests, followed by the Free tier with 200 requests/month
New onboarding email sequence for first-time users
Improved documentation with multi-language code examples

Changed

Trial accounts now receive full API access during trial period
Updated Quick Start guide with troubleshooting section

November 2025

Added

8 new coal commodity endpoints:
- COAL_USD - Newcastle Thermal Coal
- COAL_EUR - Rotterdam Coal
- COKING_COAL_USD - Premium Hard Coking Coal
- COAL_SOUTH_AFRICA_USD - Richards Bay Coal
- COAL_INDONESIA_USD - Indonesian Coal (ICI4)
- COAL_CHINA_USD - China Qinhuangdao Coal
- COAL_AUSTRALIA_USD - Australian Thermal Coal
- ANTHRACITE_USD - Anthracite Coal

Improved

Coal price update frequency now daily (previously weekly)

October 2025

Added

WebSocket streaming for real-time price updates (Professional+ plans)
WS_CONNECT endpoint at wss://api.oilpriceapi.com/cable
Real-time subscription channels for individual commodities

Changed

WebSocket connections now require Professional plan or higher
Improved connection stability with automatic reconnection

September 2025

Improved

Rate limit headers now include X-RateLimit-Used and X-RateLimit-Tier
Response time headers added to all endpoints

Correction (July 2026)

Earlier revisions of this changelog listed an "X-App-URL header bonus" (10% extra monthly requests) and related telemetry headers under this month. That feature was never built and does not exist in the API. Sending X-App-URL has no effect on your quota. The entry has been removed. See Authentication for the headers the API actually reads.

August 2025

Added

Bunker fuel endpoints for maritime industry:
- VLSFO_USD - Very Low Sulphur Fuel Oil
- HSFO_USD - High Sulphur Fuel Oil
- MGO_USD - Marine Gas Oil
- Bunker prices for 20+ major ports worldwide

Improved

Added source-specific refresh scheduling and timestamps for bunker-fuel values

July 2025

Added

Energy Intelligence endpoints (premium plans):
- /v1/rig-counts/latest - Active rig counts by region
- /v1/drilling-intelligence/well-permits - Well permit datasets
- /v1/drilling-intelligence/summary - Energy intelligence summary

Fixed

Resolved intermittent 504 timeouts on historical endpoints
Fixed pagination on /v1/prices/past_month endpoint

June 2025

Added

Futures pricing endpoints:
- /v1/futures/wti - WTI crude oil futures
- /v1/futures/brent - Brent crude futures
- /v1/futures/natural-gas - Natural gas futures
Contract expiration dates in futures responses

Changed

Historical data endpoints now support date range queries
Added start_date and end_date parameters

May 2025

Added

Currency conversion for all commodities:
- _USD, _EUR, _GBP suffixes available
- Real-time forex rates applied
New currency parameter on all price endpoints

Improved

Response times reduced by 40% with edge caching
Added Cloudflare CDN for global performance

April 2025

Added

Natural gas regional pricing:
- NATURAL_GAS_EUR - European TTF
- NATURAL_GAS_ASIA - JKM Asian LNG
- DUTCH_TTF_GAS_EUR - Dutch TTF Natural Gas

Fixed

Corrected Business Insider data source parsing
Fixed timezone issues in created_at timestamps

March 2025

Added

Refined products expansion:
- JET_FUEL_USD - Jet Fuel (Kerosene)
- GASOLINE_USD - RBOB Gasoline
- HEATING_OIL_USD - Heating Oil No. 2
- DIESEL_USD - Ultra Low Sulfur Diesel

Changed

All prices now include metadata.source_description
Improved source accuracy documentation

February 2025

Added

Account endpoint /v1/account for usage tracking
Request analytics in dashboard
Geographic usage breakdown

Improved

Rate limit error messages now include reset time
Added Retry-After header on 429 responses

January 2025

Launch

OilPriceAPI v1 launched
Core endpoints:
- /v1/prices/latest - Current prices
- /v1/prices/past_day - 24-hour history
- /v1/prices/past_week - 7-day history
- /v1/prices/past_month - 30-day history
- /v1/commodities - List all commodities
Initial commodities: WTI, Brent, Natural Gas
Token-based authentication
Rate limiting with usage headers

API Versioning Policy

v1 is stable: No breaking changes without 90-day notice
Deprecations: Announced via email and changelog
New features: Added without version bump
Breaking changes: Will trigger v2 with migration guide

Support

Email: support@oilpriceapi.com
Status: status.oilpriceapi.com
Documentation: docs.oilpriceapi.com