flow.search

anonymous ok

Search options flow

Unusual options prints (blocks, sweeps, complex, strategies) filtered by ticker, type, side, premium and DTE. Free callers get 15-minute delayed prints capped at 50 rows.

Free. Anonymous and Free callers get 15-minute delayed data capped at 50 rows.

Input

FieldTypeDescription
tickersstring[]Ticker symbols
types("block" | "sweep" | "complex" | "strategy")[]Print types; default all
rights("C" | "P")[]
sides("BUY" | "SELL")[]
min_premiumnumberMinimum premium in USD
min_dteinteger
max_dteinteger
sentiment"bullish" | "bearish"
sincestringOnly prints strictly after this timestamp
windowstringHistorical lookback window (e.g. 3h, 1d); free ≤3d, paid ≤5d
limitintegerMax rows (1–2000)Default 100.

Output

Returned under data; every response also carries meta with freshness, as_of and truncated.

FieldTypeDescription
prints*object[]

* required

Example request

curl -X POST "https://impliedoptions.com/api/v1/tools/flow.search" \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "args": {
      "tickers": [
        "SPY",
        "QQQ"
      ],
      "min_premium": 1000000,
      "limit": 20
    }
  }'

Rendered result: /flow?tab=options&tickers=SPY%2CQQQ&minPremium=1000000

Run

Anonymous: 100 runs/day, delayed.
flow.searchSearch options flowFree

Ticker symbols. Comma-separated.

Comma-separated. One or more of block, sweep, complex, strategy.

Comma-separated. One or more of C, P.

Comma-separated. One or more of BUY, SELL.

Minimum premium in USD

Only prints strictly after this timestamp

Historical lookback window (e.g. 3h, 1d); free ≤3d, paid ≤5d

Max rows (1–2000)