Derived Analytics

Day-over-day OI changes

Open-interest change per symbol between the requested day (default: latest) and the symbol's most recent earlier day with unusual flow within the previous 30 days (prev_date names it; not necessarily the previous session), at the total / call / put level. Ordered by |oi_change_pct| descending, then symbol.

A symbol is absent when it has no such prior observation, when prev_oi is below min_prev_oi, or when it had no unusual flow on the day. A zero change is present as a row with oi_change: 0 (only side=gainers|losers drop it), so "missing prior data" and "no change" are distinguishable.

get/options-flow/oi-changes

Request

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

side'gainers' | 'losers' | 'all'

gainers: positive total OI change only; losers: negative only.

min_change_pctnumber

Minimum absolute day-over-day change as a fraction (0.5 = 50%). Negative values are clamped to 0.

min_prev_oinumber

Minimum prior-day total OI, filters low-base noise. 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

OI change rows

datestring date nullable required
side'gainers' | 'losers' | 'all' required
min_prev_oinumber 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.