Build a short-squeeze view

Find the crowded names, then pressure-test the one that looks real.

The flow

1. Score the board. GetShortSqueezeScores with a liquidity floor (minMarketCap and/or minDollarVolume) so micro-caps don't dominate.
2. Read the underlying series. GetShortInterest (percent of float, days to cover), GetShortVolume, GetOffExchangeVolume, and GetFailsToDeliver.
3. Check for a catalyst. GetEarningsBrief or ListInvestorEvents — a squeeze needs a spark, and a near-term earnings date is often it.
4. See who's on each side. GetTopHolders and GetInsiderTransactions.

Prompt

Show the top short-squeeze scores among $500M+ stocks, then for the top name break down short interest, days to cover, fails-to-deliver, and whether earnings are coming up.

What you get

A ranked, liquidity-filtered board of squeeze candidates, then the raw mechanics behind one — so you can tell a genuinely crowded, catalyst-close setup from a score that's just noise. The score is peer-relative; the series behind it are the facts.