ICE Gas Oil Futures

Real-time and historical reference prices for the Gas Oil (diesel/heating oil) futures contract.

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

Front-month via /v1/prices

by_code=GASOIL_FUTURES on /v1/prices/latest (and the other /v1/prices/* endpoints) resolves to the current front-month contract — verified live 2026-09-11, it returned "code": "GASOIL_FUTURES_2026_10". Use it when you want the rolling front-month price without tracking contract expiry yourself.

Current Prices

GET /v1/futures/ice-gasoil

Response

{
  "commodity": "GASOIL_FUTURES",
  "source": "market_reporting",
  "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,
      "days_to_expiry": 8,
      "contract_status": "near_expiry",
      "is_front_month": false,
      "expiry_date": "2026-01-12",
      "open_interest": 87654
    }
  ],
  "metadata": {
    "total_contracts": 12,
    "data_source": "market_reporting",
    "front_month_contract": "2026-02"
  }
}

Enhanced Contract Fields

FieldTypeDescription
days_to_expiryintegerDays until contract expires
contract_statusstringfront_month, near_expiry, active, or expired
is_front_monthbooleanWhether this is the primary trading contract
expiry_datedateCalculated expiry date (ISO 8601)
open_interestintegerOpen interest (when available)

ICE Gas Oil contracts expire on the 12th day of the delivery month (or prior business day).

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-1825). Larger values are served as 1825 with truncated: true, days_requested, and days_served in the response
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")

Freshness during market hours

Gasoil has strict live-freshness semantics: when ICE is open and intraday data falls behind the market-hours freshness bound, the API returns 503 LIVE_DATA_STALE (with the market-hours context in the body) instead of serving stale ticks — this applies to the family-latest and /intraday endpoints. A refresh is normally triggered automatically; retry after a few minutes. Outside market hours the last session's data is served as usual, subject to the 96-hour bound. See the futures error table.

Last Updated: