---
title: "futures contracts API"
method: GET
path: "/futures/v1/contracts"
tags: ["us_futures"]
---

# futures contracts API

`GET /futures/v1/contracts`

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.

## Query parameters

- `date` string
- `date.gt` string
- `date.gte` string
- `date.lt` string
- `date.lte` string
- `product_code` string
- `product_code.any_of` string
- `product_code.gt` string
- `product_code.gte` string
- `product_code.lt` string
- `product_code.lte` string
- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `active` boolean
- `type` 'single' | 'combo'
- `type.any_of` 'single' | 'combo'
- `first_trade_date` string
- `first_trade_date.gt` string
- `first_trade_date.gte` string
- `first_trade_date.lt` string
- `first_trade_date.lte` string
- `last_trade_date` string
- `last_trade_date.gt` string
- `last_trade_date.gte` string
- `last_trade_date.lt` string
- `last_trade_date.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `active` boolean, required — 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, date, required — 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 — The number of calendar days between the 'date' and the contract's final settlement date.
    - `first_trade_date` string, date — The first day on which the contract was tradeable.
    - `group_code` string — 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, date — The last day on which the contract was tradeable.
    - `max_order_quantity` integer — The maximum order quantity.
    - `min_order_quantity` integer — The minimum order quantity.
    - `name` string — The name of this contract.
    - `product_code` string — The identifier for the contract's product.
    - `settlement_date` string, date — The date on which this contract settles.
    - `settlement_tick_size` number, double — The tick size for settlement.
    - `spread_tick_size` number, double — The tick size for spreads.
    - `ticker` string — The ticker for the contract.
    - `trade_tick_size` number, double — The tick size for trades.
    - `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'. 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.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)