Stock screener

• Python: https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output
• Javascript: https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output-nodejs

​

Delivery characteristics

• Every message is a complete row. The newest message for a ticker and date replaces every earlier one. The channel never sends a message that removes a row. Key your rows by ticker and date, and drop the rows of an earlier date once a newer one arrives.
• A ticker is sent up to once a second, whenever any of its inputs updates. A new bid or ask quote counts as an update, so during market hours most actively quoted tickers are sent every second.
• The channel sends nothing when you join. Load the current rows from /screener/stocks first, and again after every reconnect, then apply the messages from this channel on top.
• This is a high volume channel. It covers every ticker the screener tracks, and each message is about 5 KB of JSON. When the screener service restarts, every ticker is sent at once, and when the premarket session opens at 04:00 ET most tickers are.
• Keep this channel on its own connection. A client that does not read the socket fast enough is not disconnected, but frames it cannot keep up with are dropped. The drops hit every channel joined on that connection, not only this one. Enable permessage-deflate if your websocket client supports it.
• Index prices are withheld. For an index ticker (is_index is true), the channel sends null for the same price fields as /screener/stocks: open, close, high, low, prev_close, intraday_change, week_52_high, week_52_low, bid, ask, the reference closes one_week_close, one_month_close, three_month_close, six_month_close, ytd_close, one_year_close, five_year_close and last_earnings_price, and the returns one_day_perc, one_week_perc, one_month_perc, three_month_perc, six_month_perc, ytd_perc, one_year_perc, five_year_perc and earnings_perc.
• The channel is global only. There is no stock_screener:<TICKER> variant.

​

Values

​

Differences from /screener/stocks

• full_name is always null.
• These fields of /screener/stocks are not sent: net_premium, z_score, steepness_180_30, missing_periscope and the twelve gex_daily_* fields.
• net_premium is net_call_premium minus net_put_premium, so you can compute it from this channel.

[
  "stock_screener",
  {
    "date": "2026-09-18",
    "ticker": "AAPL",
    "call_volume": 1200,
    "put_volume": 800,
    "call_premium": "345000.50",
    "put_premium": "123000.25",
    "put_call_ratio": "0.6666666666666666666666666667",
    "net_call_premium": "150000",
    "net_put_premium": "-20000",
    "open": "230.00",
    "close": "231.42",
    "high": "232.10",
    "low": "229.50",
    "stock_volume": 40000000,
    "prev_close": "229.00",
    "volatility": "0.25",
    "implied_move_30": "12.345",
    "iv_rank": "34.5",
    "full_name": null,
    "marketcap": "3471300000000",
    "next_earnings_date": "2026-10-29",
    "er_time": "postmarket",
    "sector": "Technology",
    "issue_type": "Common Stock",
    "is_index": false,
    "total_open_interest": 5000000,
    "gex_gamma_per_one_percent_move_oi": "123456.78",
    "one_day_return_stddevs": "0.68",
    "one_week_close": "228.61",
    "one_day_perc": "0.0105676855895196506550218341",
    "etf_share_flow": null,
    "insider_sell_volume_3m": 120000,
    "bid": "231.41",
    "bid_quantity": 300,
    "ask": "231.43",
    "ask_quantity": 200,
    "quote_time": 1789000000000,
    "rsi_14": 57.5,
    "macd_12_26_9": 1.5,
    "macd_12_26_9_signal": 1.25,
    "macd_12_26_9_histogram": 0.25
  }
]

​

Fields