Options flow history

One symbol's prints from the archive, every session since 2025-03-31, newest first.

• Parameter symbol (string, required): Underlying.
• Parameter from (string): First day, YYYY-MM-DD. Default 30 days before to.
• Parameter to (string): Last day. Default today.
• Parameter type (string): call or put.
• Parameter kind (string): sweep, block, split or single.
• Parameter side (string): bought (at or above the ask side) or sold.
• Parameter min_premium (integer): Only prints of at least this premium, $.
• Parameter expiry (string): One expiration, YYYY-MM-DD.
• Parameter opening (boolean): Only prints larger than the open interest: new positions.
• Parameter limit (integer): Rows per page, up to 1000.
• Parameter cursor (string): next_cursor from the previous page.
• id (integer): Print id; ids rise with time.
• time (string): When it printed, UTC.
• symbol (string): Underlying (index options read SPX, NDX …).
• type (string): call or put.
• strike (number): Strike.
• expiry (string): Expiration, YYYY-MM-DD.
• spot (number): Underlying price at the print.
• size (integer): Contracts.
• premium (integer): Premium paid, $.
• price (number): Fill price per share.
• bid (number): Bid at the print (0 when the venue sent none).
• ask (number): Ask at the print.
• side (integer): -3 below the bid … 0 mid … 3 above the ask. Positive is bought.
• kind (string): sweep (across exchanges), block (a cross or 5,000+ contracts), split or single.
• condition (string): Opening (size above open interest), Spread, Floor, Auction, ISO, Complex or empty.
• open_interest (integer): Open interest before today.
• volume (integer): The contract's volume so far today.
• iv (number): Implied volatility, %.
• delta (number): Delta (puts negative).
• events (string): Pre-Earnings, Post-Earnings, ExDiv, SSR or empty.
• GET /options/flow/history: Options flow history. One symbol's prints from the archive, every session since 2025-03-31, newest first.

Updated 2026-11-06 11:42 UTC