Futures Flow

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

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

limit integer optional

Max rows (default 100, max 500).

older_than string optional

Cursor: return trades executed before this ISO8601 timestamp.

newer_than string optional

Cursor: return trades executed after this ISO8601 timestamp.

products string optional

Comma-separated CME product codes to include, e.g. ES,NQ.

side string optional

Filter by aggressor side. Case-sensitive.

enum: buy, sell

min_size integer optional

Minimum trade size (contracts).

max_size integer optional

Maximum trade size (contracts).

min_price number optional

Minimum trade price.

max_price number optional

Maximum trade price.

min_notional number optional

Minimum notional (price x size x multiplier). Needs secdef economics.

include_spreads boolean optional

Set to false to exclude calendar/spread contracts.

skip_blocks boolean optional

Set to true to exclude CME block trades.

blocks_only boolean optional

Set to true to return only CME block trades.

Responses

200 422 500

Response Body 200 OK

action string

Block rows only.

clr_sym string

Block rows only.

crossed boolean

executed_at string

is_block boolean

True for CME block trades, which carry the block-only fields below instead of size/side/nbbo.

is_spread boolean

Calendar or inter-commodity spread.

legs array[object]

Block rows only. Legs of a multi-leg (MLEG) strategy.

nbbo_ask string

nbbo_bid string

price string

product string

Example: ES

qty string

Block rows only.

reported_at string

Block rows only.

sec_type string

Block rows only.

side string

size integer

strategy_link_id integer

Block rows only.

sym string

Example: ESU6

trade_id integer

Try It GET

API Token

Query Parameters

limit integer

older_than string

newer_than string

products string

side string

min_size integer

max_size integer

min_price number

max_price number

min_notional number

include_spreads boolean

skip_blocks boolean

blocks_only boolean

Request Sample

curl -X GET "https://api.unusualwhales.com/api/futures/flow" \
  -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/flow", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "action": "string",
      "clr_sym": "string",
      "crossed": true,
      "executed_at": "string",
      "is_block": true
    }
  ]
}