Futures Contracts

GET https://api.unusualwhales.com/api/futures/contracts

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

days integer optional

Lookback in CME sessions, skipping weekends and holidays (default 3, max 30).

q string optional

Case-insensitive substring match on contract name or product.

Responses

200 422 500

Response Body 200 OK

contract_size string

CME UnitOfMeasureQty: size in the unit of measure. Original size for variable-quantity products.

expiry string

high string

is_spread boolean

True for calendar/inter-commodity spread contracts.

last_trade string

low string

multiplier string

Cash per 1.0 of price movement (tick_value / tick_size). Use this for notional.

name string

Dated contract symbol, e.g. ESU6.

Example: ESU6

product string

CME product code, e.g. ES.

Example: ES

security_id integer

tick_size string

Minimum price increment.

tick_value string

Cash value of one tick.

trades integer

unit_of_measure string

e.g. IPNT, BBL, TRYOZ.

volume integer

Try It GET

API Token

Query Parameters

days integer

q string

Request Sample

curl -X GET "https://api.unusualwhales.com/api/futures/contracts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/futures/contracts", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "contract_size": "string",
      "expiry": "string",
      "high": "string",
      "is_spread": true,
      "last_trade": "string"
    }
  ]
}