Sign in

v

latestOpenAPI 3.1.0Proprietary2026-08-091,5543,1956.4 MB
Finance

Futures price history

OHLCV history for a futures root. Returns the continuous front-month series by default, or a specific dated contract when 'expiration' (YYYY-MM) is supplied. Use period OR start/end, not both. Volatility roots (VX) are settlement-basis (price_type=settlement, T-1 daily bars with a settle column): expiration also accepts an exact YYYY-MM-DD date (weekly contracts); with no expiration the current front monthly contract is served (contract=front_month) - no continuous series exists on a settlement basis.

get/api/v2/futures/{root}/historical

Path parameters

rootstring required

Futures root symbol.

Futures root symbol.

Query parameters

periodstring nullable

1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max

1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max

startstring nullable

YYYY-MM-DD

YYYY-MM-DD

endstring nullable

YYYY-MM-DD

YYYY-MM-DD

intervalstring

1m, 5m, 15m, 1h, 1d, 1wk, 1mo

1m, 5m, 15m, 1h, 1d, 1wk, 1mo

expirationstring nullable

Dated contract expiration month (YYYY-MM). Omit for continuous front-month.

Dated contract expiration month (YYYY-MM). Omit for continuous front-month.

Response

OHLCV bars for the continuous or dated futures series.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}