Futures
Premium

Get historical ICE Gas Oil futures data

Changed on

Daily ICE Low Sulphur Gas Oil futures rows per contract month (USD per metric tonne), or weekly/monthly bars with interval. /v1/futures/gasoil/historical is an identical instrument-named alias. When no rows match the window the response is HTTP 200 with error and available_dates instead of contracts.

Premium Feature - Futures data access required.

get/v1/futures/ice-gasoil/historical

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    API key in header Authorization

Query parameters

contract_monthstring
Example:2026-12

One delivery month in YYYY-MM form; omit to receive every contract in the window. contracts is accepted as a synonym.

fromstring date
Example:2026-09-01

Start of the window (ISO date). Omit both from and to for the last 30 days. The window may not exceed 730 days. start_date is accepted as an alias (end_date for to). Unrecognised query parameters return 400 UNKNOWN_PARAMETERS (#5913).

tostring date
Example:2026-10-09

End of the window (ISO date). Defaults to today.

daysinteger
Example:90

The last N days ending today, as an alternative to from/to (days=30 equals the default window). Cannot be combined with from, to, start_date or end_date.

interval'daily' | 'weekly' | 'monthly'
Example:daily

Server-side aggregation. weekly and monthly replace trading_date with period_start/period_end and add avg_close and trading_days.

format'json' | 'csv'
Example:json

json (default) or csv. Any other value returns 400.

Response

Historical gas oil futures data

commoditystring
interval'1d' | '1w' | '1m'
trading_days_onlyboolean
total_recordsinteger
metadataobject

Plain-language definitions of the price and change fields (close, close_captured_at, settlement, change_percent, change_from_prior_close_percent, change_from_prior_settlement_percent).

errorstring

Example response

{
  "commodity": "BRENT_FUTURES",
  "date_range": {
    "from": "2026-10-10",
    "to": "2026-11-09"
  },
  "interval": "1d",
  "trading_days_only": true,
  "total_records": 345,
  "contracts": [
    {
      "contract_month": "2026-12",
      "contract_code": "BRENT_FUTURES_2026_12",
      "total_days": 20,
      "daily_data": [
        {
          "code": "BRENT_FUTURES_2026_12",
          "trading_date": "2026-10-12",
          "open": "103.66",
          "high": "107.14",
          "low": "102.54",
          "close": "106.14",
          "volume": 348290,
          "change_percent": "2.3924"
        }
      ]
    }
  ],
  "error": "No data available for the specified date range",
  "available_dates": {
    "earliest": "2023-11-13"
  }
}

Changes

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the new optional query request parameter days