> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Unusual Whales: Get Short Screener

Screen for most-shorted stocks and short squeeze candidates. Returns ticker, short interest, market date, short shares available, total float, short float percentage, days to cover, borrow fee rate, and rebate rate across all tickers. Ideal for: finding squeeze candidates, screening by short float percentage, building short-interest-based alerts.

![Unusual Whales: Get Short Screener logo](https://cdn.b3.fun/unusual_whales.png)
Catalog action Blockchain Data

Screen for most-shorted stocks and short squeeze candidates. Returns ticker, short interest, market date, short shares available, total float, short float percentage, days to cover, borrow fee rate, and rebate rate across all tickers. Ideal for: finding squeeze candidates, screening by short float percentage, building short-interest-based alerts.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `unusualwhales-get-short-screener` |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `screening`, `trading`, `market-data`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `number` | No | Maximum number of stocks to return |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `stocks` | `array` | Yes | List of most-shorted stocks |

## Examples

**Workflow node**

```json
{
  "type": "unusualwhales-get-short-screener",
  "payload": {
    "limit": 1
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/unusualwhales-get-short-screener/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "limit": 1
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.