---
title: "Get the European gasoil crack"
method: GET
path: "/v1/spreads/gasoil-crack"
tags: ["Spreads"]
---

# Get the European gasoil crack

`GET /v1/spreads/gasoil-crack`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/spreads/gasoil-crack`
- Auth: API key in header `Authorization`

ICE Low Sulphur Gasoil against ICE Brent — the European refining-margin benchmark, and an exchange-listed instrument (ICE 'Low Sulphur Gasoil/Brent Futures Crack'; CME NYMEX rulebook ch.143).

Computed as `(gasoil USD/tonne / 7.45) - brent USD/bbl`, where 7.45 is the exchange-standard barrels per metric tonne.

Distinct from `/v1/spreads/crack`, which computes SPOT cracks on the US product slate. This one is futures-native — there is no gasoil spot code — so the response names the exact contract month used for each leg.

## Response `200`

Current European gasoil crack

- object
  - `status` string
  - `data` object
    - `spread_type` string
    - `name` string
    - `value` number
    - `unit` string
    - `components` object
      - `product` object
        - `code` string
        - `contract_month` string
        - `updated_at` string, date-time: When this leg's settle was collected. On a weekend this is Friday's settle time — futures-derived data serves under the same bound as /v1/futures/*.
        - `settlement_date` string, date: Exchange trading session the settle belongs to, when known.
        - `price` number
        - `unit` string
      - `crude` object
        - `code` string
        - `contract_month` string
        - `updated_at` string, date-time: When this leg's settle was collected.
        - `settlement_date` string, date: Exchange trading session the settle belongs to, when known.
        - `price` number
        - `unit` string
    - `conversion` object
      - `barrels_per_tonne` number
      - `basis` string
      - `gasoil_usd_per_bbl` number
    - `timestamp` string, date-time
    - `updated_at` string, date-time: Newest collection time across the two legs.

## Other responses

- `401`: Missing or invalid API key.
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

## Changes

- **2026-09-02** `e2de540143c4`: 5 info
  - added the optional property `data/components/crude/settlement_date` to the response with the `200` status
  - added the optional property `data/components/crude/updated_at` to the response with the `200` status
  - added the optional property `data/components/product/settlement_date` to the response with the `200` status
  - added the optional property `data/components/product/updated_at` to the response with the `200` status
  - …1 more
- **2026-08-30** `a7f1136fa319`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/spreads/gasoil-crack/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/7f8b4d763210?raw)