Derived Analytics

Daily unusual-flow sentiment

Per-symbol sentiment of the day's unusual flow - call/put volumes, premium, open interest, net delta, C/P ratios, average IV per side, plus bullish/bearish classification with strength_score 0-9 and the screener confirmations behind it. Defaults to the latest scan day; with a range each (symbol, date) pair is a row. Ordered by total premium (call + put) descending, then date desc, then symbol.

One row per symbol that had unusual flow on the day. Rows without a signal carry side, signal_type and strength_score as null; only side and signal_only exclude them. min_strength treats a missing signal as 0, so min_strength=0 is a no-op. A symbol absent from the complete result had no unusual contract that day.

get/options-flow/sentiment

Request

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

date_fromstring date

Inclusive lower bound, YYYY-MM-DD.

date_tostring date

Inclusive upper bound, YYYY-MM-DD. Must not be before date_from (400 INVALID_DATE_RANGE).

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.

sectorstring

GICS sector name, exact match (e.g. Information Technology).

side'bullish' | 'bearish'

Only rows classified with this signal side.

signal_onlyboolean

1 or true: only rows with an active bullish/bearish signal. Implied by side.

min_strengthinteger

Minimum strength_score. Floored and clamped to 0-9. Rows without a signal count as 0, so 0 excludes nothing.

min_premiumnumber

Minimum call + put total 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

Sentiment rows

datestring date nullable required
date_fromstring date nullable required
date_tostring date nullable 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.