Oil Price API Documentation - Quick Start in 5 Minutes | REST API
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
  • Commodities

    • List Commodities
    • Get Commodity Details
  • Marine Fuels

    • List Marine Fuel Ports
    • Get Port Details with Prices
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
  • Dark Data (Premium)

    • Dark Data API
    • Rig Counts
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Analytics

    • Analytics API
  • Account & Billing

    • Account API

ICE Gas Oil Futures

Real-time and historical Gas Oil (diesel/heating oil) futures data from the Intercontinental Exchange (ICE).

Endpoints

MethodEndpointDescription
GET/v1/futures/ice-gasoilCurrent contract prices
GET/v1/futures/ice-gasoil/historicalHistorical data
GET/v1/futures/ice-gasoil/ohlcDaily OHLC
GET/v1/futures/ice-gasoil/intraday5-minute intervals
GET/v1/futures/ice-gasoil/spreadsCalendar spreads
GET/v1/futures/ice-gasoil/curveFutures curve
GET/v1/futures/ice-gasoil/spread-historySpread history

Current Prices

GET /v1/futures/ice-gasoil

Response

{
  "commodity": "GASOIL_FUTURES",
  "source": "ICE",
  "updated_at": "2025-12-29T14:30:00.000Z",
  "trading_hours": "01:00-23:00 GMT",
  "contracts": [
    {
      "contract_month": "2026-01",
      "last_price": 685.50,
      "currency": "USD",
      "unit": "metric_ton",
      "open": 683.25,
      "close": 685.00,
      "high": 687.75,
      "low": 682.50,
      "volume": 45678,
      "change_percent": 0.29
    }
  ]
}

Historical Data

GET /v1/futures/ice-gasoil/historical

Parameters

ParameterTypeDefaultDescription
fromdate30 days agoStart date
todatetodayEnd date
contractsstringallContract months
formatstringjsonjson or csv

OHLC Data

GET /v1/futures/ice-gasoil/ohlc

Parameters

ParameterTypeDefaultDescription
daysinteger30Period (1-365)
contractstringfront monthContract month

Intraday Data

GET /v1/futures/ice-gasoil/intraday

Parameters

ParameterTypeDefaultDescription
datedatetodayTrading date
contractstringfront monthContract month

Calendar Spreads

GET /v1/futures/ice-gasoil/spreads

Parameters

ParameterTypeDefaultDescription
pairsstringconsecutiveSpread pairs
daysinteger30Analysis period

Futures Curve

GET /v1/futures/ice-gasoil/curve

Parameters

ParameterTypeDefaultDescription
datedatetodayAnalysis date

Spread History

GET /v1/futures/ice-gasoil/spread-history

Parameters

ParameterTypeRequiredDescription
front_contractstringYesFront contract
back_contractstringYesBack contract
daysintegerNoHistory period

Quick Example

import requests

response = requests.get(
    "https://api.oilpriceapi.com/v1/futures/ice-gasoil",
    headers={"Authorization": "Token YOUR_API_KEY"}
)
data = response.json()

print(f"Gas Oil Front Month: ${data['contracts'][0]['last_price']}/MT")

Related

  • ICE Brent Futures
  • ICE WTI Futures
  • NYMEX Natural Gas Futures
Last Updated: 12/30/25, 11:36 AM
Prev
ICE WTI Futures
Next
NYMEX Natural Gas Futures