latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

benzinga9

crypto:aggregates7

crypto:last:trade1

crypto:open-close1

crypto:snapshot4

crypto:trades2

etfglobal5

fable2

fed4

financials4

futures:aggregates1

fx:aggregates7

fx:conversion1

fx:last:quote1

fx:quotes1

fx:snapshot3

fx:trades1

global_crypto1

global_forex1

indices:aggregates6

indices:snapshot1

options:aggregates6

options:last:trade1

options:open-close1

options:quotes1

options:snapshot2

options:trades1

reference14

reference:conditions1

reference:dividends1

reference:exchanges1

reference:news1

reference:options:contract1

reference:options:contracts:list1

reference:related:companies1

reference:sec:filing1

reference:sec:filing:file1

reference:sec:filing:files1

reference:sec:filings1

reference:stocks2

reference:stocks:ipos1

reference:stocks:market2

reference:tickers:get2

reference:tickers:list1

reference:tickers:types1

stocks:aggregates7

stocks:last:quote1

stocks:last:trade1

stocks:open-close2

stocks:quotes2

stocks:snapshot3

stocks:trades2

tmx1

us_futures8

us_options3

us_stocks_all2

us_stocks_reference3

us_futures

futures contracts API

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.

get/futures/v1/contracts

Query parameters

datestring

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'.

date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

product_codestring

The identifier for the contract's product.

product_code.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

product_code.gtstring

Filter greater than the value.

product_code.gtestring

Filter greater than or equal to the value.

product_code.ltstring

Filter less than the value.

product_code.ltestring

Filter less than or equal to the value.

tickerstring

The ticker for the contract.

ticker.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

ticker.gtstring

Filter greater than the value.

ticker.gtestring

Filter greater than or equal to the value.

ticker.ltstring

Filter less than the value.

ticker.ltestring

Filter less than or equal to the value.

activeboolean

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'single' | 'combo'

The type of contract, one of 'single' or 'combo'. Leaving this filter blank will query for contracts where type is 'single', 'combo' or empty. This field only exists on contracts as of 2025-03-12 and later. It will be null when date < 2025-03-12.

type.any_of'single' | 'combo'

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

first_trade_datestring

The first day on which the contract was tradeable. Value must be formatted 'yyyy-mm-dd'.

first_trade_date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

first_trade_date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

first_trade_date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

first_trade_date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

last_trade_datestring

The last day on which the contract was tradeable. Value must be formatted 'yyyy-mm-dd'.

last_trade_date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

last_trade_date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

last_trade_date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

last_trade_date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '1000'.

sortstring

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

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.