Your first stock screen

The stock screener allows you to screen all tickers in the market with over 200+ filters. From volatility filters, stock returns (both percentage as well as log based and std moves), options flow, gex, ta, fundamentals, buyback programs and much more. Note: Since we return for each ticker over 200 fields in a response we will omit and shorten the responses in our examples.

Make your first request

Set up your API key

Get the API token from the API dashboard:

export UW_API_KEY="YOUR_API_KEY"

Request stocks with at least $1 billion in market capitalization

curl --fail-with-body --get 'https://api.unusualwhales.com/api/screener/stocks' \
  --header "Authorization: Bearer $UW_API_KEY" \
  --data-urlencode 'min_marketcap=1000000000' \
  --data-urlencode 'limit=10'

Read a result

An example response would look like this. As mentioned in the introduction we omitted other fields in this example as there are over 200 fields.

{
  "data": [
    {
      "ticker": "AAPL",
      "date": "2026-09-18",
      "close": "230.00",
      "marketcap": "3450000000000",
      "call_volume": 120000,
      "put_volume": 50000,
      "total_open_interest": 1500000
    }
  ]
}

Choose your next screen

Build and combine filters

Translate screening conditions and comparisons between fields into requests.

Options activity

Find stocks with call and put volume imbalances.

Volatility

Compare IV horizons and price moves relative to IV.

Last modified on October 7, 2026

Overview

Guides

Make your first request

Choose your next screen

Build and combine filters

Options activity

Volatility

​Make your first request

​Choose your next screen

Build and combine filters

Options activity

Volatility

Make your first request

Choose your next screen