Skip to main content
API documentation

Futures Data API

Futures responses include contract-month, front-month, source timestamp, and freshness-warning fields so applications can tell which instrument they are reading. Public market sites may show a spot benchmark, continuous series, settlement value, or another contract month.

Get API KeyBrent Futures Semantics

Build a forward curve

/v1/futures/ice-brent/curve

Use product-scoped curve routes when applications need available contract months with source and timestamp context.

Compare front-month values

/v1/futures/ice-wti

Read front_month and contract_month before comparing OilPriceAPI to another public market screen.

Backtest daily signals

/v1/futures/ttf-gas/ohlc

Use OHLC routes where available for charting, backtests, and risk workflows that should not depend on latest tick shape.

Use JKM safely

/v1/futures/lng-jkm

Treat JKM as a delayed/reference curve and check source semantics before describing values as official settlement data.

Example response shape

{
  "commodity": "BRENT_FUTURES",
  "source": "ICE",
  "updated_at": "2026-05-10T15:30:00Z",
  "front_month": {
    "code": "BRENT_FUTURES_2026_07",
    "contract_month": "2026-07",
    "last_price": 75.2,
    "updated_at": "2026-05-10T15:30:00Z",
    "is_front_month": true,
    "contract_status": "front_month"
  },
  "contracts": [
    {
      "code": "BRENT_FUTURES_2026_07",
      "contract_month": "2026-07",
      "last_price": 75.2,
      "updated_at": "2026-05-10T15:30:00Z"
    }
  ],
  "metadata": {
    "front_month_contract": "2026-07",
    "contract_selection": {
      "front_month_definition": "nearest non-expired contract after commodity-specific expiry and roll rules",
      "benchmark_contract_definition": "not separate from front_month_contract unless a future endpoint returns explicit benchmark_contract metadata",
      "freshness_warning_basis": "front_month contract when available; otherwise the first three non-expired contract months",
      "comparison_note": "Public market sites may show a spot benchmark, continuous futures series, or a different contract month"
    }
  }
}

contract_month

The delivery month for a futures contract, formatted as YYYY-MM when available.

front_month

The selected front-month contract after commodity-specific expiry and roll rules.

updated_at

The source-observed timestamp for the returned value.

data_age_warning

A warning based on the front-month contract when available, otherwise near non-expired contracts.

Futures route matrix

ProductCurrent routeHistorical routeCurve routeUsage note
ICE Brent/v1/futures/ice-brent/v1/futures/ice-brent/historical/v1/futures/ice-brent/curveUse contract_month before comparing to spot Brent or another site's continuous series.
WTI/v1/futures/ice-wti/v1/futures/ice-wti/historical/v1/futures/ice-wti/curveCheck front-month selection and expiry behavior before comparing to Cushing spot references.
ICE Gasoil/v1/futures/ice-gasoil/v1/futures/ice-gasoil/historical/v1/futures/ice-gasoil/curveUseful for middle-distillate workflows and diesel-linked analysis.
Natural Gas/v1/futures/natural-gas/v1/futures/natural-gas/historical/v1/futures/natural-gas/curveHenry Hub futures route; do not compare directly to regional cash gas pages.
EUA Carbon/v1/futures/eua-carbon/v1/futures/eua-carbon/historical/v1/futures/eua-carbon/curveCarbon futures route for EUA workflows, subject to package/source rights.
TTF Gas/v1/futures/ttf-gas/v1/futures/ttf-gas/historical/v1/futures/ttf-gas/curveEuropean gas futures workflow; compare separately from spot or day-ahead gas references.
JKM LNG/v1/futures/lng-jkm/v1/futures/lng-jkm/historical/v1/futures/lng-jkm/curveDelayed/reference 12-contract curve; not official CME settlement data.
/v1/futures/ice-brent

ICE Brent futures contracts

/v1/futures/ice-wti

WTI futures contracts

/v1/futures/ice-gasoil

ICE gasoil futures contracts

/v1/futures/natural-gas

NYMEX natural gas futures contracts

/v1/futures/eua-carbon

ICE EUA carbon futures contracts

/v1/futures/ttf-gas

ICE TTF natural gas futures contracts

/v1/futures/lng-jkm

JKM LNG 12-contract delayed/reference curve; not official CME settlement data

/v1/futures/continuous/brent

Brent continuous front-month reference series

/v1/futures/continuous/wti

WTI continuous front-month reference series

Product-scoped suffixes

Brent, WTI, gasoil, natural gas, EUA carbon, TTF gas, and JKM LNG expose the same suffix family: /historical, /ohlc, /intraday, /spreads, /curve, /spread-history. Continuous Brent and WTI expose /historical.

Comparison checklist

  • Check whether the other source is spot, futures, continuous, or settlement.
  • Compare contract_month before deciding a value is stale or wrong.
  • Use updated_at and data_age_warning for freshness decisions.
  • Confirm package/source rights before using exchange or redistribution claims.
  • For JKM, check coverage_status and source_semantics before calling data official.