Changelog

All notable changes to the OilPriceAPI are documented here.

The format is based on Keep a Changelog.

December 2025

Added

• 7-day free trial with 10,000 requests (replaces limited free tier)
• 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

Added

• X-App-URL header bonus: 10% extra requests for sharing your app URL
• New telemetry headers: X-App-Name, X-SDK-Name, X-SDK-Version
• Dashboard setting to configure app URL for bonus

Improved

• Rate limit headers now include X-Monthly-Quota and X-Monthly-Usage
• Response time headers added to all endpoints

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

• Bunker fuel prices now updated every 15 minutes

July 2025

Added

• Drilling intelligence endpoints (Business+ plans):
  • /v1/drilling/rig-count - Active rig counts by region
  • /v1/drilling/permits - New drilling permits
  • /v1/drilling/production - Production forecasts

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: [email protected]
• Status: status.oilpriceapi.com
• Documentation: docs.oilpriceapi.com