Early access is open. Free sample datasets are live now. Download a sample

API Reference: Futures Bars and Continuous Contracts

Details

Docs navigation

A single futures contract lives a few months, so futures data needs two views: bars for a specific contract such as ESZ6, and a continuous series such as ES.C1 that stitches contracts together across rolls. This futures API endpoint reference covers both, plus the contract list you need to know which months exist and when they expire.

Early access. Planned v1 endpoints, not live yet. Free: front-month daily bars, end of day, 1 year. Starter ($29/mo): full daily history, 1-minute bars 10 minutes delayed with 5 years of history, and daily continuous series in all three adjustments. Pro ($79/mo): 1-second to daily bars, intraday continuous series and a custom roll rule. Business ($249/mo): real-time WebSocket bars, CME user fees passed through at cost. Contract specs are free on every plan.

Details

Contract bars

GET https://api.marketdata.co/v1/futures/bars

Parameters

Name Type Required Default Description
symbol string yes Contract, e.g. ESZ6, CLF7
interval string no 1d 1s, 1m, 5m, 1h, 1d
start, end string no 1 year Dates or UTC timestamps
limit, cursor, format no Paging and output

Response fields

Field Type Description
symbol string Contract
root string Product root, e.g. ES
exchange string e.g. CME
interval string Bar size
timestamp string Intraday bar start, UTC
date string Daily bars: session date
session_date string Intraday: trading day the bar belongs to
open, high, low, close number Trade prices
volume number Contracts traded
trade_count, vwap number Optional
settlement_price number Daily bars: official settlement (optional)
open_interest number Daily bars: open contracts (optional)
buy_aggressor_volume, sell_aggressor_volume number Optional

Example (curl):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.marketdata.co/v1/futures/bars?symbol=ESZ6&interval=1d&start=2026-09-01"

Example response row (illustrative values):

{
  "symbol": "ESZ6",
  "root": "ES",
  "exchange": "CME",
  "interval": "1d",
  "date": "2026-11-18",
  "open": 6718.50,
  "high": 6761.25,
  "low": 6702.00,
  "close": 6742.25,
  "volume": 1384216,
  "settlement_price": 6742.50,
  "open_interest": 2051376
}

Details

Continuous contracts

GET https://api.marketdata.co/v1/futures/continuous

Parameters

Name Type Required Default Description
symbol string yes Root plus position: ES.C1 front, ES.C2 second
adjustment string no back_adjusted none, back_adjusted (additive, Panama), ratio_adjusted
roll_rule string no volume volume, open_interest, first_notice, fixed_days_before_expiry
roll_days integer no 5 With fixed_days_before_expiry (Pro)
interval string no 1d Intraday on Pro
start, end, limit, cursor, format no As above

Response fields

All bar fields above, plus:

Field Type Description
adjustment, roll_rule string Settings used
underlying_symbol string Contract used for this bar, e.g. ESZ6
unadjusted_close number Raw close of that contract (optional)
cumulative_adjustment number Total offset or ratio applied so far (optional)
is_roll_date boolean True on the bar where the series switched contract

Example (Python), back-adjusted crude oil with roll dates marked:

import os
import requests
import pandas as pd

r = requests.get(
    "https://api.marketdata.co/v1/futures/continuous",
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
    params={"symbol": "CL.C1", "adjustment": "back_adjusted", "roll_rule": "volume",
            "interval": "1d", "start": "2015-01-01"},
)
cl = pd.DataFrame(r.json()["results"]).set_index("date")
print(cl.loc[cl["is_roll_date"], ["underlying_symbol", "unadjusted_close", "close"]].tail())

Details

Contract list

GET https://api.marketdata.co/v1/futures/contracts?root=ES returns each contract with symbol, name, exchange, asset_class, contract_month, first_trade_date, last_trade_date, expiration_date, first_notice_date, settlement_method, contract_multiplier, tick_size, tick_value, currency, trading_hours and is_active. Add is_active=false for expired contracts.

API

Errors for these endpoints

HTTP error.code When
400 invalid_symbol_format ESZ2026 or /ESZ6; use ESZ6
400 invalid_parameter Unknown adjustment or roll_rule, or roll_days without the fixed-days rule
403 plan_required Intraday bars on Free, intraday continuous or custom roll below Pro, real time below Business
404 symbol_not_found Contract or root we do not carry

Watch out

Notes and gotchas

  • Back-adjusted prices can go negative on long histories, especially crude oil. That is expected with additive adjustment. Use ratio_adjusted if your strategy works on percentage returns.
  • Use the back-adjusted series for signals and unadjusted_close for P&L in points or position sizing.
  • Group intraday bars by session_date. A CME Globex session for most products opens at 17:00 Chicago time the evening before.
  • Daily close is the last trade; settlement_price is the exchange's official mark, which can differ. Most margin and P&L calculations use settlement.
  • Single-digit years repeat each decade. contract_month in the contract list is unambiguous.
  • History limits for continuous series follow your plan's limits for contract bars.

Keep reading

Next steps

Details

Was this page useful?

[Yes] [No]

Need a roll rule we don't offer? Tell us on the custom data form.