Derived Analytics

Multi-day unusual-flow streaks

Symbols showing unusual options activity for min_streak or more consecutive trading days as of the requested day (default: latest). dominant_side is call when the call/put volume ratio is >= 1, otherwise put; side filters on it. Ordered by streak_days descending, then total premium descending, then symbol.

One row per symbol that had unusual flow on the day; streak_days is never below 1. With min_streak=1 and side=all, a symbol that is absent from the complete result (page through with offset, or has_more false) had no unusual contract that day.

get/options-flow/streaks

Request

  • Base URL: https://optionsbell.com/api/v1
  • URL: https://optionsbell.com/api/v1/options-flow/streaks
  • Auth: API key in header X-API-Key

Query parameters

datestring date

A specific trading day, YYYY-MM-DD (must be a real calendar day). Default is the latest available day.

symbolsstring

Comma-separated tickers, case-insensitive (e.g. AAPL,NVDA). Tokens must match ^[A-Z][A-Z0-9.\-]{0,9}$; invalid tokens next to valid ones are dropped, no valid token at all is 400 INVALID_SYMBOLS.

min_streakinteger
side'call' | 'put' | 'all'
min_volumenumber

Minimum total contract volume on the day. Negative values are clamped to 0.

limitinteger
offsetinteger

Rows to skip (default 0, negative values are clamped to 0). Page with limit + offset; the envelope reports filtered_total and has_more. count < limit on any page, or has_more false, means the filtered result is complete.

Response

Streak rows

datestring date nullable required
min_streakinteger required
side'call' | 'put' | 'all' required
countinteger required
limitinteger required
offsetinteger required
filtered_totalinteger required

Rows matching the filters across all pages (0 when the page is past the end).

has_moreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.