Derived Analytics

IV rank snapshot

IV rank and IV percentile per symbol as of the latest available day, computed from each symbol's history of daily average IV (percent).

  • *_iv_rank = (current - min) / (max - min) over the window, 0..1; null when max equals min.
  • *_iv_percentile = share of sessions with lower IV, 0..1.
  • side picks the rank used for min_rank / max_rank, for ordering and for the iv_rank field: call, put, or both (default) = GREATEST(call_iv_rank, put_iv_rank).
  • Default lookback is the full available history; lookback_days restricts it. Symbols with fewer than 20 sessions are excluded.

Ordered by iv_rank descending, then symbol.

get/options-flow/iv-rank

Request

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

Query parameters

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'call' | 'put' | 'both'
min_ranknumber

Clamped to 0..1.

max_ranknumber

Clamped to 0..1.

lookback_daysinteger

Calendar days of history to rank against. Default is the full available history.

limitinteger

Response

IV rank rows

datestring date nullable required
side'call' | 'put' | 'both' required
lookback_daysinteger nullable required

Echo of the parameter; null = full history.

countinteger required

Changes

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