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

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 endpoints

/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

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.