Unusual Whales UnusualWhales API

Short Screener

GET https://api.unusualwhales.com/api/short_screener

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

tickers Ticker optional

A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a `-`.

Example: AAPL,INTC
limit optional

The limit of results. Default: 100. Max: 500. Min: 0.

Example: 125 Default: 100
>= 0 <= 500
offset optional

The offset of results. Default: 0. Min: 0.

Example: 100 Default: 0
>= 0
min_short_interest optional

The min short interest.

Example: 5000
max_short_interest optional

The max short interest.

Example: 100000
min_days_to_cover optional

The min days to cover.

Example: 1.1
max_days_to_cover optional

The max days to cover.

Example: 5.3
min_si_float optional

The min short interest float ratio.

Example: 0.1
max_si_float optional

The max short interest float ratio.

Example: 0.05
min_si_float_with_synth_long_pct_of_total_shares optional

The min si_float_with_synth_long_pct_of_total_shares.

Example: 0.05
max_si_float_with_synth_long_pct_of_total_shares optional

The max si_float_with_synth_long_pct_of_total_shares.

Example: 0.05
min_total_float optional

The min total float.

Example: 10000000
max_total_float optional

The max total float.

Example: 100000000
order_by ShortScreenerOrderBy optional

ordering options.

Example: market_date
order_direction OrderDirection optional

Whether to sort descending or ascending. Descending by default.

Example: asc Default: desc
enum: desc, asc
min_market_date Market Date optional

A trading date in the format of YYYY-MM-DD.

Example: 2024-01-18
max_market_date Market Date optional

A trading date in the format of YYYY-MM-DD.

Example: 2024-01-18
min_fee_rate optional

The min fee rate.

Example: 0.01
max_fee_rate optional

The max fee rate.

Example: 0.45
min_rebate_rate optional

The min rebate rate.

Example: 0.11
max_rebate_rate optional

The max rebate rate.

Example: 5.34
min_short_shares_available optional

The min short shares available.

Example: 0
max_short_shares_available optional

The max short shares available.

Example: 10000

Responses

200 422 500

Response Body 200 OK

days_to_cover string

The estimated number of days to cover all short positions based on average daily trading volume.

fee_rate date

The fee rate.

market_date date

The date of the short interest data.

rebate_rate date

The rebate rate.

short_interest integer

The total number of shares sold short.

short_shares_available date

The short shares available.

si_float string

The short interest float ratio.

si_float_with_synth_long_pct_of_total_shares string

The short interest float ratio with volume of shares sold short added to total float.

symbol string

The ticker symbol.

total_float integer

The float (available shares for trading).

Try It GET
Query Parameters
Request Sample 
curl -X GET "https://api.unusualwhales.com/api/short_screener" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response Example 200 
{
  "data": {
    "days_to_cover": "2.1",
    "fee_rate": "0.2782",
    "market_date": "2023-04-15",
    "rebate_rate": "3.3518",
    "short_interest": 75000,
    "short_shares_available": 10000000,
    "si_float": "0.017647058",
    "si_float_with_synth_long_pct_of_total_shares": "0.01734104046",
    "symbol": "EXMP",
    "total_float": 4250000
  }
}