Options Flows

GET/retail/options/flows

Track aggregated retail options flow by underlying ticker.

Query Parameters

lookback_daysintegeroptional

Allowed values: 1, 3, 7, 14, 30, 90, 365

Default: 7

Lookback window in days.

underlyingstringoptional

Options underlying ticker.

min_trade_valuenumberoptional

Default: 0

Minimum trade value threshold.

min_unique_tradersintegeroptional

Default: 3

Minimum trader cell threshold before aggregation is returned.

limitintegeroptional

Default: 100

Maximum number of rows to return.

Was this page helpful?

GET/retail/options/flows

curl "https://api.rallies.ai/v1/retail/options/flows?underlying=NVDA&lookback_days=7&limit=50" \
  -H "X-Rallies-API-Key: $RALLIES_API_KEY"

RESPONSE

JSON

{
  "flows": [
    {
      "underlying": "NVDA",
      "active_trader_share_pct": 3.76,
      "call_share_pct": 64.29,
      "opening_share_pct": 71.43,
      "short_dated_share_pct": 42.86,
      "buy_premium_usd": 182400.22,
      "sell_premium_usd": 90450.1,
      "net_premium_usd": 91950.12,
      "gross_premium_usd": 272850.32,
      "net_premium_pct": 33.7,
      "premium_bias": "net_buying",
      "latest_trade_at": "2026-05-25T10:12:08Z"
    }
  ]
}