Coverage
What you get
| Item | Detail |
|---|---|
| Product code | FUT-STATS |
| Coverage | US futures by contract month, starting with CME Group products |
| Granularity | One row per contract per session |
| History | Free: prior day for front months. Starter: full history for all contracts |
| Delivery | REST, CSV files per root |
| Update speed | Daily; preliminary same-day settlements on Pro |
The settlement price is not the last trade. Exchanges set it from trading in a short window near the close, and it's the price your account is marked to every night. If your backtest uses the last trade instead, daily PnL won't match a real futures statement, sometimes by several ticks.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | e.g. ESZ6 |
date |
string | yes | Session the numbers belong to |
settlement_price |
number | yes | Official settlement |
settlement_type |
string | yes | final or preliminary |
previous_settlement_price |
number | optional | Prior session settlement |
open_interest |
number | yes | Open contracts (all 5) |
cleared_volume |
number | optional | Volume cleared for the session |
high_limit_price |
number | optional | Upper daily price limit |
low_limit_price |
number | optional | Lower daily price limit |
exchange_margin |
number | optional | Initial margin per contract, USD |
timestamp |
string | optional | When the exchange published the value, ISO 8601 UTC |
Example record:
{
"symbol": "ESZ6",
"date": "2026-11-18",
"settlement_price": 6742.50,
"settlement_type": "final",
"previous_settlement_price": 6719.75,
"open_interest": 2051376,
"cleared_volume": 1384216,
"high_limit_price": 7213.50,
"low_limit_price": 6271.50,
"timestamp": "2026-11-18T22:31:04.512000Z"
}
Sample data
Sample data
There's no free settlement sample yet. CME posts settlements on its own site, but redistributing them still falls under the CME licence we're arranging. A sample file is available on request for any root.
Use cases
Use cases
Mark-to-market PnL. Day-over-day change in settlement_price times the contract multiplier is the variation margin that moves in or out of your account. Use it to rebuild what your broker will show.
Open interest trends. Rising open_interest with a rising price says new longs are coming in; falling OI on a rally points to short covering. Sum OI across all months of a root for the total picture.
Limit moves. high_limit_price and low_limit_price tell you where trading would halt or be capped. Check them before you size a position in a product that has hit limits before, such as grains or crude.
Preliminary vs final. On Pro you get the preliminary settlement shortly after the close and the final one later. A strategy that trades on settlement needs to know which one it saw.
Code
Code examples
Example: CL settlements and OI for one contract.
curl "https://api.marketdata.co/v1/futures/stats?symbol=CLF7&start=2026-10-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, total open interest across all ES contracts by day.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/futures/stats",
params={"root": "ES", "start": "2026-06-01", "settlement_type": "final"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
stats = pd.DataFrame(resp.json()["results"])
total_oi = stats.groupby("date")["open_interest"].sum()
print(total_oi.tail(20))
Pricing
Pricing
| Plan | Settlements and open interest |
|---|---|
| Free, $0 | Prior-day settlement and OI for front months |
| Starter, $29/mo | Full history for all contracts |
| Pro, $79/mo | Adds same-day preliminary settlements and price limits |
Settlements are included in the futures daily bar files, or $19 per root for full history on their own. Prices are early access and may change.
Only two published prices exist for this data among the vendors we studied, at $199 and $375 a month, and both come bundled with much more.
Side by side
How we compare
5 of the 50 providers we studied sell futures settlements and open interest as data, and public history is thin. We give the prior day away free, put full history in the $29 plan, and keep symbol and date identical to our futures bars so the join is trivial.
FAQ
Frequently asked questions
What's the difference between settlement and close?
The close is the last trade. Settlement is the exchange's official price for the day, set by its own procedure from trading near the end of the session, and it's what margin is calculated on.
When are settlements published?
Preliminary settlements come out shortly after the close, and final ones follow later. settlement_type says which you have, and timestamp says when the exchange published it.
Is open interest for the same day?
OI is reported for the session in date, but exchanges publish it the following morning. Treat it as known the next day in any backtest.
Do you include margins?
exchange_margin is an optional field for the initial margin per contract where we have it. Your broker may require more.
What format are the files?
CSV, one file per root, with the same columns as the API.
Keep reading
Related
- Asset hub: Futures
- Contracts: ES, NQ, YM, RTY, CL, GC
- Docs: API reference: futures stats and COT
- Learn: COT report explained