Coverage
What you get
| Item | Detail |
|---|---|
| Product code | FUT-REFERENCE |
| Coverage | US futures contracts we carry, active and expired, across equity index, rates, energy, metals, agriculture, FX and crypto |
| Granularity | One record per contract month |
| History | Expired contracts included |
| Delivery | REST, plus a free downloadable expiry calendar CSV |
| Update speed | Updated as the exchange lists new contracts or changes terms |
Getting a spec wrong costs real money. Size an ES trade with the NQ multiplier and you're off by a factor of 2.5. Hold a physically delivered contract past its first notice day and your broker will be on the phone. This data is the boring table that stops both.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | e.g. ESZ6 |
root |
string | yes | e.g. ES |
name |
string | yes | e.g. E-mini S&P 500 Dec 2026 |
exchange |
string | yes | e.g. CME |
asset_class |
string | yes | equity_index, interest_rate, energy, metals, agriculture, fx, crypto |
contract_month |
string | yes | YYYY-MM |
first_trade_date |
string | yes | YYYY-MM-DD |
last_trade_date |
string | yes | YYYY-MM-DD |
expiration_date |
string | yes | YYYY-MM-DD |
first_notice_date |
string | optional | Physically delivered contracts |
settlement_method |
string | yes | cash or physical |
contract_multiplier |
number | yes | Point value in currency, e.g. 50 |
tick_size |
number | yes | Minimum price step |
tick_value |
number | yes | Currency value of one tick |
settlement_tick_size |
number | optional | Tick used for settlement where different |
currency |
string | yes | e.g. USD |
trading_hours |
string | optional | Session in exchange local time, e.g. Sun-Fri 17:00-16:00 CT |
is_active |
boolean | yes | Still trading |
days_to_expiry |
number | optional | Calendar days left |
exchange_margin |
number | optional | Initial margin per contract |
cfi_code |
string | optional | ISO 10962 code |
Example record:
{
"symbol": "ESZ6",
"root": "ES",
"name": "E-mini S&P 500 Dec 2026",
"exchange": "CME",
"asset_class": "equity_index",
"contract_month": "2026-12",
"first_trade_date": "2025-09-19",
"last_trade_date": "2026-12-18",
"expiration_date": "2026-12-18",
"settlement_method": "cash",
"contract_multiplier": 50,
"tick_size": 0.25,
"tick_value": 12.50,
"currency": "USD",
"trading_hours": "Sun-Fri 17:00-16:00 CT, daily break 16:00-17:00",
"is_active": true,
"days_to_expiry": 29
}
Sample data
Sample data
The free expiry calendar CSV isn't published yet. Until it is, a sample file of specs and expiries is available on request for any roots you trade.
Use cases
Use cases
Position sizing. Risk per contract is your stop distance in points times contract_multiplier. For ES that's $50 a point, so a 10-point stop is $500 a contract. tick_value gives you the same thing per tick.
Roll calendars. Pull last_trade_date and first_notice_date for every contract of a root and you have a roll schedule. For physically delivered contracts like CL and GC, roll before first notice; for cash-settled ES, roll before last_trade_date.
Session-aware code. trading_hours gives the exchange's own schedule, including the daily maintenance break. Use it to stop your bot sending orders into a closed market.
Building symbols. Combine root and contract_month to generate valid symbol values for any date, instead of hardcoding next quarter's contract.
Code
Code examples
Example: active ES contracts.
curl "https://api.marketdata.co/v1/futures/contracts?root=ES&is_active=true" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, next roll dates for a list of roots.
import os
import requests
import pandas as pd
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
rows = []
for root in ["ES", "NQ", "YM", "RTY", "CL", "GC"]:
r = requests.get(
"https://api.marketdata.co/v1/futures/contracts",
params={"root": root, "is_active": "true"},
headers=headers,
)
r.raise_for_status()
rows += r.json()["results"]
specs = pd.DataFrame(rows).sort_values("last_trade_date")
front = specs.groupby("root").first()
print(front[["symbol", "last_trade_date", "first_notice_date", "contract_multiplier", "tick_value"]])
Pricing
Pricing
| Plan | Contract specs |
|---|---|
| Free, $0 | Full contract list including expired contracts |
| Starter, Pro, Business | Same data, higher rate limits |
Specs are free on all plans and aren't sold as a dataset. The expiry calendar CSV is planned as a free download.
Vendors we studied price this anywhere from $0 to $375 a month, almost always as part of a larger bundle.
Side by side
How we compare
6 of the 50 providers we studied publish futures contract specs through an API or files. Some only show them on web pages, which is no help to your code. We make the full list free, include expired contracts and first notice dates, and use the same symbol and root as our bars, ticks and settlements.
FAQ
Frequently asked questions
What's the difference between last trade date and expiration date?
For most contracts they're the same day. Some products have a final settlement or expiration a little after trading stops, which is why we keep both fields.
What is first notice day?
For physically delivered contracts, it's the first day the exchange can assign delivery to holders of long positions. Speculators normally roll or close before it. Cash-settled contracts like ES have no first notice day.
Are trading hours in my time zone?
No. trading_hours is in the exchange's local time as published, for example Central Time for CME. Timestamps everywhere else in our data are UTC.
Do you include margins?
exchange_margin is an optional field for initial margin where we have it. Margins change often and your broker may ask for more.
Is it really free?
Yes, on every plan including Free. Paid plans only raise the rate limit.
Keep reading
Related
- Asset hub: Futures
- Contracts: ES, NQ, YM, RTY, CL, GC
- Docs: API reference: futures, Symbology
- Learn: Futures contract months and symbols