Options Flow Outliers API - Cross-Symbol Scanner

Endpoint

GET /v1/flow/options/outliers

Auth required (X-Api-Key) Rate Limited: Yes Alpha plan+

Parameters

Name	In	Required	Default	Description
`limit`	query	no	20	Rows returned, clamped to `1..200`
`minTrades`	query	no	20	Minimum trades for a symbol to qualify
`windowMinutes`	query	no	240	Lookback window, clamped to `1..10080`

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/options/outliers?limit=20&minTrades=50&windowMinutes=240"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/options/outliers",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
data = resp.json()
print(f"{data['qualified']} of {data['tracked']} symbols qualified")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/options/outliers",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();
console.log(data.qualified + " of " + data.tracked + " symbols qualified");

API Key

Response

{
  "generatedUtc": "2026-05-12T18:42:10Z",
  "windowMinutes": 240,
  "tracked": 1840,
  "qualified": 612,
  "limit": 20,
  "outliers": [
    {
      "symbol": "NVDA",
      "tradeCount": 18420,
      "buyVolume": 152400,
      "sellVolume": 67880,
      "midVolume": 8420,
      "netVolume": 84520,
      "imbalancePct": 0.62,
      "skew": 2.24,
      "notional": 76820000,
      "netNotional": 28450000,
      "biggestTrade": 4800,
      "biggestTradeUtc": "2026-05-12T17:18:42Z",
      "biggestAgeSec": 5008,
      "lastVwap": 3.42,
      "lastTradeUtc": "2026-05-12T18:42:08Z",
      "lastTradeAgeSec": 2
    }
  ]
}

Key Response Fields

Field	Type	Description
`generatedUtc`	string	Generation timestamp
`windowMinutes`	integer	Effective lookback window
`tracked`	integer	Symbols/underlyings scanned
`qualified`	integer	Symbols that met filters
`limit`	integer	Effective output limit
`outliers[]`	array	Outlier rows: `symbol`, `tradeCount`, `buyVolume`, `sellVolume`, `midVolume`, `netVolume`, `imbalancePct`, `skew`, `notional`, `netNotional`, `biggestTrade`, `biggestTradeUtc`, `biggestAgeSec`, `lastVwap`, `lastTradeUtc`, `lastTradeAgeSec`

Errors

Status	Description
`403`	Requires Alpha plan or higher
`502`	Upstream flow data source unavailable

About

Surfaces the option universe's most directional names by absolute net notional, with extra context fields (imbalancePct, skew, biggest-trade timing) that the leaderboard doesn't carry. Filter out thin tape with minTrades. Cached 30 seconds on the server.

Common Use Cases

Unusual-options-activity scanner: top names by skew over a 4-hour window
Big-trade detector: surface symbols where biggestAgeSec is small (recent prints)
Imbalance ranking: filter on imbalancePct > 0.5 for one-sided tape
Watchlist refresh: replace stale names with current outliers each session