Home Module

Apps · Flow

flow: options flow scanner

flow is the ConvexValue Terminal app that ranks stocks by their options activity. It is a live table with one row per underlying, ordered by the column you choose: premium traded, call buying, put buying, or any other of 100+ columns.

How to use flow

flow [param=value ...]
flow

flow takes no symbol: it scans the whole market. Type the command in the command bar of a pane, or set the same parameters in the control panel (the ⚙️ at the right of the bar). In a browser, the app opens at convexvalue.com/go/flow/.

The flow app with its default columns: value, price and change

Parameters

Parameter Values Default What it does
cols Underlying parameters, separated by commas value,price,change The columns of the table, after the symbol.
orderby One underlying parameter value The column that ranks the rows.
limit A whole number 50 How many rows to show.
asc t or f f asc puts the smallest value first. Without it the largest is first.
filters Conditions, separated by commas: column>number, column<number, column=number none Keeps the rows that meet every condition.
s Symbols, separated by commas none Rows that stay on top, whatever the order and the filters.

The columns are the Underlying Parameters of the Data Parameters page. The control panel lists them too.

Examples

flow

The default: stocks ranked by value, the options premium traded today, with the stock's price and change.

flow cols=value,price,change,volm_call_buy,volm_put_buy orderby=volm_call_buy

Ranked by the volume of calls bought, with the volume of puts bought next to it.

The flow app ordered by the volume of call buys
flow cols=value,price,change,volm_call_buy,volm_put_buy,vflowratio orderby=vflowratio filters=value>1000000,volm_put_buy>100

Ranked by vflowratio, among stocks with more than $1M of premium traded and more than 100 puts bought. The filters leave out the illiquid names that a ratio alone would put on top.

flow s=AAPL,MSFT,NVDA

The default ranking, with AAPL, MSFT and NVDA kept in the first three rows.

flow orderby=put_call_ratio limit=20 filters=option_volume>50000

The 20 highest put/call ratios, among underlyings with more than 50,000 options traded.

How to read it

  • Each row is one underlying. The first column is its rank, the second its symbol, then your columns in the order of cols.
  • value is premium: the dollars paid for the options traded today on that underlying. volm is the number of contracts.
  • A column ending in _buy or _sell counts the trades where the buyer or the seller was the aggressor. volm_call_buy is the volume of calls bought, value_put_sell the premium of puts sold.
  • flowratio is (premium of call buys + put sells) / (premium of put buys + call sells). vflowratio is the same with volume. Above 1, the first group is larger; below 1, the second.
  • The cells update as trades arrive. The ranking itself is drawn again every 10 seconds, so a row can move.
  • In the desktop app, a click on a symbol sets it as the global symbol.
  • opt: the same kind of ranking for single option contracts.
  • tas: the single trades behind the totals.
  • flowchart: one symbol's flow through the session.
  • flowsum: one symbol's totals by expiration.