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

Data product · Early access

Futures Contract Specifications and Expiry Calendar

The rulebook for every futures contract in one place: tick size and value, point value, trading hours, last trade date, first notice day and how it settles. Free on every plan.

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