European Gasoil Crack

The European refining-margin benchmark: ICE Low Sulphur Gasoil against ICE Brent, each taken from the front-month futures contract currently held.

Endpoints

There is no /historical or /all variant for this spread.

Formula

crack (USD/bbl) = gasoil (USD/tonne) / 7.45 - brent (USD/bbl)

7.45 barrels per metric tonne is the ICE/CME listed contract convention (1,000 metric tonnes = 7,450 barrels). Subtracting the raw quotes without the conversion gives a number roughly 7.45x too large.

Example

curl "https://api.oilpriceapi.com/v1/spreads/gasoil-crack" \
  -H "Authorization: Token YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "spread_type": "gasoil",
    "name": "European gasoil crack (ICE Low Sulphur Gasoil vs ICE Brent)",
    "value": 76.73,
    "unit": "USD/bbl",
    "components": {
      "product": {
        "code": "GASOIL_FUTURES_2026_09",
        "contract_month": "2026-09",
        "price": 1208.50,
        "unit": "USD/tonne"
      },
      "crude": {
        "code": "BRENT_FUTURES_2026_11",
        "contract_month": "2026-11",
        "price": 85.48,
        "unit": "USD/bbl"
      }
    },
    "conversion": {
      "barrels_per_tonne": 7.45,
      "basis": "ICE/CME listed convention: 1,000 metric tonnes = 7,450 barrels",
      "gasoil_usd_per_bbl": 162.21
    },
    "timestamp": "2026-08-25T14:02:11Z"
  }
}

Values are illustrative. The two legs can sit in different delivery months for about a week around each monthly roll, so each leg names its own contract_month. Each price is reported in the unit it was quoted in, together with the conversion applied, so the value can be re-derived and reconciled against the exchange.

Error Cases

Known issue: because each leg needs a tick from the last 24 hours, the endpoint currently returns 404 at weekends, when neither ICE contract trades (tracked as api#7603).

See Spreads & Margins for access rules and common error handling.