All Contracts
GET
/futures/vX/contracts
Futures REST access is currently in beta and coming soon.
Retrieve a list of futures contracts with filtering options based on parameters such as product code, first and last trade dates, point-in-time (as_of), and active status. This endpoint returns an index of contracts with key attributes including ticker, trade dates, days to maturity, and order quantity limits, presented in paginated responses for easy navigation.
Use Cases: Contract discovery, historical research, portfolio integration, risk management.
Query Parameters
product_code
string
A unique identifier for the Product a Contract belongs to. Note that multiple contracts can belong to the same product.
first_trade_date
string
The first day that a contract was tradeable. A date with the format YYYY-MM-DD.
last_trade_date
string
The last day that the contract was tradeable. A date with the format YYYY-MM-DD.
as_of
string
Specify the point-in-time for which you want to retrieve information. Note that the contract data returned for a given date is the state of that contract as of that day. A date in the format YYYY-MM-DD (default=today).
active
enum (string)
Filter for contracts based on whether or not they were tradeable at the given point in time. For example, if the date queried is greater-than or equal-to a contract's 'first_trade_date' and less-than-or-equal-to its 'last_trade_date', then the contract was active. If the date queried is greater-than-or-equal-to the contract's 'last_trade_date' or less-than-or-equal-to its 'first_trade_date', then the contract was inactive.
type
enum (string)
The type of contract, one of "all", "single", or "combo" (default=all).
limit
integer
The number of results to return per page (default=100, max=1000, min=1).
sort
enum (string)
Sort results by field and direction using dotted notation (e.g., 'ticker.asc', 'name.desc').
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
optional
A unique identifier for this request.
results
array (object)
optional
active
boolean
optional
Whether or not this contract was tradeable at the given point-in-time specified in the 'as_of' attribute (a contract was active if the given day was after the 'first_trade_date' and before the 'last_trade_date').
as_of
string
optional
The point-in-time date for the given contract - e.g. if 'as_of' is set to 2021-04-25, then the data retrieved describes the contract(s) as of 2021-04-25.
days_to_maturity
integer
optional
The number of days until this contract matures (since the point-in-time date). Note that the absence of this field means there are 0 days until maturity.
first_trade_date
string
optional
The date on which this contract first became tradeable.
last_trade_date
string
optional
The date on which this contract last became tradeable.
maturity
string
optional
This field provides the calendar month reflected in the instrument symbol. For futures spreads and options spreads, this field contains the first leg's calendar month reflected in the instrument symbol. For daily products, this tag contains the full calendar date (YYYYMMDD) as reflected in the instrument symbol.
max_order_quantity
integer
optional
The maximum order quantity for this contract.
min_order_quantity
integer
optional
The minimum order quantity for this contract.
name
string
optional
The name of the contract.
product_code
string
The unique identifier for the product to which this contract belongs.
settlement_date
string
optional
The final settlement date for the contract.
settlement_tick_size
number
optional
The settlement tick size for this contract.
spread_tick_size
number
optional
The spread tick size for this contract.
ticker
string
The unique identifier for the contract, typically consisting of the product code and expiration date.
trade_tick_size
number
optional
The tick size for this contract.
trading_venue
string
The trading venue (MIC) for the exchange on which this contract trades.
type
string
The type of contract, one of "single" or "combo".
status
string
optional
The status of this request's response.