Contract Overview
GET
/futures/vX/contracts/{ticker}Futures REST access is currently in beta and coming soon.
Retrieve detailed information about a specific futures contract identified by its ticker. The response includes comprehensive attributes such as active status, trade dates, days to maturity, exchange code, order quantity limits, settlement date, tick sizes, and other key metrics. Users can specify a point-in-time (as_of) to view the contract's state on a particular date, supporting informed trading decisions and historical analysis.
Use Cases: Contract specification, historical product checks, system integration, trading decision support.
Path Parameters
ticker
string
required
The ticker symbol of the contract to retrieve.
Query Parameters
as_of
string
The point-in-time of the data to be retrieved. Note that the contract data returned for a given date represents the state of that contract on that day. A date in the format YYYY-MM-DD (default=today).
Response Attributes
request_id
string
optional
A unique identifier for this request.
results
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.