Contracts
GET
/futures/vX/contracts
Futures REST access is currently in beta and coming soon.
The Contracts API provides a single source for discovering all listed futures contracts and retrieving complete contract specifications. You can query the full contract index with filters for product code, trade dates, active status, and date, returning key attributes such as ticker, first and last trade dates, days to maturity, exchange code, and order quantity limits in paginated form. The same API also returns the full specification for a single contract, including settlement dates, tick sizes, and other trading and risk related fields. Point-in-time lookups allow you to reconstruct the exact contract definition that applied on any given day.
Use Cases: Historical research, trading system integration, portfolio workflows, risk management.
Use Cases: Historical research, trading system integration, portfolio workflows, risk management.
Plan Accessloading..
Plan
Recency
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Updated daily
Plan Recencyloading..
Plan
History
All history
2 years
2 years
5 years
All history
All history
All history
All history
All history
All history
2 years
2 years
5 years
All history
Plan Historyloading..
Query Parameters
date
string
A date string in the format YYYY-MM-DD. This parameter will return point-in-time information about contracts for the specified day. Value must be formatted 'yyyy-mm-dd'.
product_code
string
The identifier for the contract's product.
ticker
string
The ticker for the contract.
active
boolean
Whether or not a given contract was tradeable at the given point in time. Active is true when (first_trade_date <= date >= last_trade_date) and false otherwise.
type
enum (string)
The type of contract, one of 'single' or 'combo'. Leaving this filter blank will query for both 'single' and 'combo' types.
first_trade_date
string
The first day on which the contract was tradeable. Value must be formatted 'yyyy-mm-dd'.
last_trade_date
string
The last day on which the contract was tradeable. Value must be formatted 'yyyy-mm-dd'.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '1000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'product_code' if not specified. The sort order defaults to 'asc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
active
boolean
Whether or not a given contract was tradeable at the given point in time. Active is true when (first_trade_date <= date >= last_trade_date) and false otherwise.
date
string
A date string in the format YYYY-MM-DD. This parameter will return point-in-time information about contracts for the specified day.
days_to_maturity
integer
optional
The number of calendar days between the 'date' and the contract's final settlement date.
first_trade_date
string
optional
The first day on which the contract was tradeable.
group_code
string
optional
An identifier used to identify logical groups of products. The group_code is only populated for contracts listed for trading on CME Globex.
last_trade_date
string
optional
The last day on which the contract was tradeable.
max_order_quantity
integer
optional
The maximum order quantity.
min_order_quantity
integer
optional
The minimum order quantity.
name
string
optional
The name of this contract.
product_code
string
optional
The identifier for the contract's product.
settlement_date
string
optional
The date on which this contract settles.
settlement_tick_size
number
optional
The tick size for settlement.
spread_tick_size
number
optional
The tick size for spreads.
ticker
string
optional
The ticker for the contract.
trade_tick_size
number
optional
The tick size for trades.
trading_venue
string
optional
The trading venue (MIC) for the exchange on which this contract trades.
type
string
optional
The type of contract, one of 'single' or 'combo'. Leaving this filter blank will query for both 'single' and 'combo' types.
status
enum (OK)
The status of this request's response.
Code Examples
Query URL
GET
loading...Run query unavailable
Create account or sign in to Massive
Scroll to see updated query response
Response Object