Skip to main content
Glama
squeeze-radar

squeeze-radar

๐Ÿ“ก SqueezeRadar

Find crowded shorts BEFORE the squeeze.

One command. Five exchanges. Zero API keys. SqueezeRadar scans crypto perpetual futures, ranks coins by how negative their funding rate is, and scores each one 0โ€“100 for short-squeeze potential.

GitHub stars License: MIT Python 3.12 MCP Tools

โญ If this saves you from one bad short, star the repo โ€” it takes 2 seconds and helps more traders find the radar.

When funding goes very negative, shorts are paying longs to stay short. That's crowded โ€” and crowded shorts are squeeze fuel. SqueezeRadar watches funding across Bitget, Gate, Binance, Bybit and OKX, and shows you where the pile-up is before price rips through it.

No keys. No signup. No orders. Pure read-only public data.


โšก 60-Second Setup

git clone https://github.com/muslim-ahmad-wagay/SqueezeRadar.git
cd SqueezeRadar
python3.12 -m venv .venv
.venv/bin/pip install -r requirements.txt

Then run it:

.venv/bin/python squeeze_radar.py --top 20

Done. That's the whole setup โ€” no API keys, no account, no config file.

SqueezeRadar v1.0.0 โ€” most crowded shorts (Bitget universe)
  exchange bitget  : ok
  exchange gate    : ok

#   Symbol            Price      Funding   Gate fund.   24h chg  Score  Read
----------------------------------------------------------------------------------------
1   CYBERUSDT      0.280100     -0.5675%     -1.1169%   -10.31%     77  crowded shorts
2   BRETTUSDT      0.003713     -0.3856%     +0.0050%    -5.13%     61  crowded shorts
3   RSRUSDT        0.001743     -0.2907%     -0.3886%   +11.23%     95  crowded shorts
...

(Example output from a real scan, 2026-11-08. Your numbers will differ โ€” funding moves every 4โ€“8 hours.)


Related MCP server: crypto-quant-signal-mcp

๐ŸŽฏ Easy Usage โ€” just ask your AI

SqueezeRadar is also an MCP server. Plug it into Claude Desktop, Claude Code, Cursor, Windsurf, VS Code or ChatGPT, and talk to it like a trader:

What you want

Copy-paste this prompt

Find the squeeze

Scan for the most crowded shorts right now โ€” top 10 with funding and squeeze scores

Check one coin

Is IDOL crowded? Check its funding across all exchanges

Hunt the rip

Which coin has the most negative funding AND is already pumping?

Cross-check

Compare RSR funding on Bitget vs Gate โ€” do both exchanges agree?

Before you short

I'm thinking of shorting HOT โ€” check the funding first and tell me if it's crowded

Exchange health

Which exchanges can the radar reach right now?

CLI cheatsheet

python squeeze_radar.py --top 20            # ranked table, most crowded first
python squeeze_radar.py --symbol IDOLUSDT    # deep-check one coin, all 5 exchanges
python squeeze_radar.py --top 10 --json      # machine-readable JSON
python squeeze_radar.py --top 10 --watch 15  # re-scan every 15 minutes
python squeeze_radar.py --mcp                # run as an MCP server (stdio)

Symbols are forgiving: IDOL, IDOLUSDT, idol/usdt, IDOL/USDT:USDT all work. Typos fail cleanly with a clear error, never a crash.


๐Ÿ† Why traders love it

  • Sees the pile-up first โ€” funding tells you where shorts are trapped before price moves.

  • Five exchanges, one command โ€” Bitget, Gate, Binance, Bybit, OKX. If one is geo-blocked where you live, the radar says so and keeps scanning the rest.

  • Honest score, not hype โ€” a transparent 0โ€“100 formula you can read in 2 minutes. No black box, no "guaranteed squeeze".

  • Zero keys, zero risk โ€” read-only public data. It cannot place orders, move funds, or touch your accounts. There is nothing to leak.

  • Works everywhere โ€” CLI for the terminal, MCP for Claude, ChatGPT, Cursor and friends.

  • Free forever โ€” MIT licensed. No subscription, no paywall, no "pro tier".


๐Ÿงฎ How the squeeze score works

Score 0โ€“100, built from four honest pieces:

Piece

Max

What it measures

Funding

60

How negative the funding rate is. โˆ’0.30% earns the full 60. Only negative funding scores โ€” crowded longs score 0 here.

Momentum

20

24h price change. A coin already pumping +10% with crowded shorts is hotter.

Liquidity

10

24h USDT volume. Real signal on liquid coins scores higher than dust. Coins under $100k volume are ignored entirely.

Agreement

10

Gate.io funding is also negative โ€” two exchanges agreeing beats one.

Read labels: funding โ‰ค โˆ’0.10% โ†’ crowded shorts ยท between โˆ’0.10% and +0.10% โ†’ neutral ยท โ‰ฅ +0.10% โ†’ crowded longs.

The honest part: funding settles every 4โ€“8 hours, so this is a slow crowding filter, never a 15-minute entry trigger. A crowded short can stay crowded for days, and price can keep falling while funding is negative. The score is a heuristic, not a prediction. This is not financial advice.


๐ŸŒ What it scans

Exchange

Role

Status

Bitget

Primary universe โ€” one call returns ~884 USDT-futures tickers with funding included

Works everywhere tested

Gate.io

Cross-check โ€” ~1080 contracts with funding

Works everywhere tested

OKX

Per-symbol funding (listed coins only)

Works everywhere tested

Binance

Per-symbol funding

Geo-blocked (HTTP 451) in some regions โ€” reported, never fatal

Bybit

Per-symbol funding

CloudFront-blocked (HTTP 403) in some regions โ€” reported, never fatal

If an exchange is unreachable from your location, SqueezeRadar prints that in the output and keeps going. It never crashes the whole scan because one exchange is down, and it never invents numbers โ€” every figure comes from a live API response.


๐Ÿ”Œ Connect it (MCP โ€” Claude, ChatGPT, Cursorโ€ฆ)

Paste this into your Claude Desktop config (claude_desktop_config.json), fixing the path โ€” the same JSON works in Cursor, Windsurf, VS Code, and ChatGPT's desktop app (developer mode):

{
  "mcpServers": {
    "squeeze-radar": {
      "command": "/absolute/path/to/SqueezeRadar/.venv/bin/python",
      "args": ["/absolute/path/to/SqueezeRadar/squeeze_radar.py", "--mcp"]
    }
  }
}

Restart the app. Three tools appear:

Tool

What it does

scan_crowded_shorts

Ranked scan of the most crowded shorts, with squeeze scores

check_funding

Deep-check one coin's funding across all 5 exchanges

squeeze_radar_status

Which exchanges the radar can reach right now

Check the tools without starting the server:

python squeeze_radar.py --dump-tools

๐Ÿ›ก๏ธ Safety

  • Read-only by design. Only public market-data endpoints. No keys, no logins, no orders, no trading โ€” the code literally cannot move money.

  • No credentials in this repo. No keys, secrets, passwords or tokens anywhere โ€” grep it yourself.

  • No invented numbers. Every funding rate comes from a live exchange response. Unreachable exchanges are labelled, not silently skipped.

  • No guaranteed squeezes. A high score means crowded shorts, not a certain rip. Do your own research, size positions, use stop-losses.

  • This is not financial advice. The radar shows you the market; it does not tell you what to buy or short.


๐Ÿงช Tests

# Live smoke test: real top-5 scan + IDOL check + bad-symbol handling
python tests/smoke_test.py

The test hits the real public APIs and asserts the ranking is sorted most-negative first, funding is numeric, scores are 0โ€“100, and a garbage symbol fails cleanly.


๐Ÿ“ฃ Share the radar

Help it go viral โ€” copy, paste, post:

X / Twitter:

Shorts are piling up somewhere right now โ€” and you can't see it.

๐Ÿ“ก SqueezeRadar scans 5 exchanges, ranks coins by funding rate and scores the squeeze before it happens. One command, zero API keys.

https://github.com/muslim-ahmad-wagay/SqueezeRadar

Reddit (r/CryptoCurrency, r/algotrading, r/ClaudeAI):

Title: SqueezeRadar โ€” find crowded shorts before the squeeze (5 exchanges, 0 keys)

Body: Funding rates show where shorts are trapped. This tool scans Bitget + Gate + Binance + Bybit + OKX, ranks the most negative funding, and scores each coin 0โ€“100 for squeeze potential. CLI + MCP for Claude/ChatGPT. Free, MIT, no keys: https://github.com/muslim-ahmad-wagay/SqueezeRadar

Discord / Telegram:

๐Ÿ“ก SqueezeRadar โ€” crowded shorts radar for crypto perps. 5 exchanges, 60-second setup, no API keys. https://github.com/muslim-ahmad-wagay/SqueezeRadar


๐Ÿค Contributing

PRs welcome โ€” new exchanges, better scoring, more tests. Rules:

  1. Read-only public data only. Never add a tool that moves funds.

  2. Never invent a number โ€” every figure must come from a live API response.

  3. An unreachable exchange is reported, never fatal.

  4. Keep the honesty notes intact: funding is a slow filter, not a trigger, and nothing here is financial advice.


๐Ÿ’› Support

SqueezeRadar is free and open source (MIT). If it helps you trade smarter, tips keep the radar running:

USDT (TRC20): TPWtGkxHsrNtUY7cAuPtZzSX7otzE44zyo

Donations are voluntary and non-refundable. Never send funds to any other address claiming to be SqueezeRadar.


๐Ÿ“œ License

MIT โ€” see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Real-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.
      15
      33 PyPI
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI clients to access live crypto market data and AI-driven quantitative analysis, with structured outputs and full observability.
      -