---
title: "Get historical ICE Gas Oil futures data"
method: GET
path: "/v1/futures/ice-gasoil/historical"
tags: ["Futures", "Premium"]
---

# Get historical ICE Gas Oil futures data

`GET /v1/futures/ice-gasoil/historical`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/futures/ice-gasoil/historical`
- Auth: API key in header `Authorization`

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.

## Query parameters

- `contract_month` string
- `from` string, date
- `to` string, date
- `days` integer
- `interval` 'daily' | 'weekly' | 'monthly'
- `format` 'json' | 'csv'

## Response `200`

Historical gas oil futures data

- HistoricalFuturesResponse: Futures history grouped by contract month. Verified against production responses from the Brent, WTI, natural gas and gas oil history routes on 2026-11-09. Prices are decimal strings. Daily rows carry `trading_date`; `interval=weekly` or `monthly` rows carry `period_start`, `period_end`, `avg_close` and `trading_days` instead. When no rows match the window, the body is `{error, available_dates}` with HTTP 200.
  - `commodity` string
  - `date_range` object
    - `from` string, date
    - `to` string, date
  - `interval` '1d' | '1w' | '1m'
  - `trading_days_only` boolean
  - `total_records` integer
  - `contracts` object[]
    - `contract_month` string
    - `contract_code` string
    - `total_days` integer
    - `daily_data` object[]
      - `code` string
      - `trading_date` string, date
      - `period_start` string, date
      - `period_end` string, date
      - `open` string, nullable
      - `high` string, nullable
      - `low` string, nullable
      - `close` string, nullable
      - `avg_close` string, nullable
      - `settlement` string, nullable: Exchange settlement where one was captured for this contract and session; null otherwise. Never copied from close.
      - `settlement_available` boolean: True only when this row carries a captured exchange settlement (daily interval).
      - `volume` integer, nullable
      - `open_interest` integer, nullable
      - `trading_days` integer
      - `change_percent` string, nullable: Captured close versus captured open, percent.
      - `open_captured_at` string, date-time, nullable
      - `close_captured_at` string, date-time, nullable: When the price reported as close was collected (UTC); our collection time, not a settlement time.
      - `change_from_prior_close_percent` number, nullable: Captured close versus this contract's previous captured close, percent (daily interval). Weekends and missed sessions are bridged up to 7 days; null when no earlier close exists.
      - `prior_close_date` string, date, nullable
      - `change_from_prior_settlement_percent` number, nullable
      - `prior_settlement_date` string, date, nullable
  - `metadata` object: 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).
  - `error` string
  - `available_dates` object
    - `earliest` string, date
    - `latest` string, date
    - `total_days` integer

## Other responses

- `400`: Invalid parameter, for example a window wider than 730 days, an unsupported `interval`, or a `format` other than json or csv.
- `401`: Missing or invalid API key.
- `403`: Futures data access required.
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

## Changes

- **2026-11-15** `ea22019fbf1b`: 3 info
  - added the optional property `contracts/items/daily_data/items/change_from_prior_close_percent` to the response with the `200` status
  - added the optional property `contracts/items/daily_data/items/prior_close_date` to the response with the `200` status
  - added the optional property `contracts/items/daily_data/items/settlement_available` to the response with the `200` status
- **2026-11-12** `6e3981554d8d`: 1 info
  - added the new optional `query` request parameter `days`
- **2026-11-10** `abcce0611b94`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/futures/ice-gasoil/historical/get.md)

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/ea22019fbf1b?raw)
