Changelog

All notable changes to the OilPriceAPI are documented here.

The format is based on Keep a Changelog.

August 2026

Changed

Free tier is now 50 requests per day, replacing the previous 200 requests per month (effective 2026-08-05). The window changed as well as the number: the allowance now resets daily rather than monthly, so a 402 Payment Required on the Free tier clears at the next daily reset instead of the next month. In monthly terms the allowance is roughly 7.5x larger than before. Paid plans are unchanged and remain monthly: Developer 10,000/month, Starter 50,000/month, Professional 100,000/month, Scale 1,000,000/month. See Rate Limiting for the full table.

July 2026

Added

UK carbon (UKA) forward curve — GET /v1/futures/uk-carbon/curve, term-structure analysis parallel to eua-carbon/curve. Note the URL slug is uk-carbon (contract codes remain UKA_FUTURES_*).
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

Published OpenAPI examples now use Authorization: Token YOUR_API_KEY for API keys, retain Bearer only for JWT sessions, advertise only the production API server, and explain recovery for payment, rate-limit, and transient server errors.
Commodity catalog pages now use source-timestamped freshness language, omit stale generated price/date snapshots, and provide direct Python and JavaScript quickstarts for every catalog entry.
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