Unusual Activity

Top prints of the day

The day's biggest bets, ranked by premium_estimate descending (rank is the 1-based position) - the view that also powers the alert emails. A thin, ranked cut over the same contract-level data as /options-flow/unusual, without the base floor: only min_premium applies.

Not a fixed global top-N: every print that passes the filters is reachable through limit + offset. symbols, type and min_premium are applied before ranking, rank is the position in the full filtered set and keeps counting across pages. Ordered by premium_estimate desc, then symbol, option_symbol, so paging is deterministic; a finished day is immutable and repeatable.

get/options-flow/top

Request

  • Base URL: https://optionsbell.com/api/v1
  • URL: https://optionsbell.com/api/v1/options-flow/top
  • 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.

type'c' | 'p' | 'all' | 'call' | 'calls' | 'put' | 'puts'

Contract side, case-insensitive: c / call / calls, p / put / puts, or all.

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_premiumnumber

Minimum estimated premium in USD. 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

Ranked top prints

datestring date nullable required
type'call' | 'put' | 'all' required

Normalized side filter.

min_premiumnumber 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.