API Reference: Futures Bars and Continuous Contracts
Details
Docs navigation
- Getting started: Quickstart, Authentication, Rate limits, Errors and retries
- Guides: Symbol formats, Timestamps and time zones, Pagination, Split and dividend adjustments, WebSocket streaming, Dataset downloads, Excel and Google Sheets, Changelog
- API reference: Stock bars, Stock trades and quotes, Snapshots and movers, Tickers, exchanges, calendar, Splits and dividends, Fundamentals and SEC filings, Options chain and Greeks, Options EOD, bars, OI, Forex, Crypto, Crypto derivatives, Futures bars and continuous (you are here), Settlements and COT, Indices, Economic data, Technical indicators
- SDKs: Python, JavaScript
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_adjustedif your strategy works on percentage returns. - Use the back-adjusted series for signals and
unadjusted_closefor 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
closeis the last trade;settlement_priceis the exchange's official mark, which can differ. Most margin and P&L calculations use settlement. - Single-digit years repeat each decade.
contract_monthin 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.