{"uid":"cap_y2UeQzIN4C1uuHlWdP2Oa","slug":"squeezesignal-8b64ab98","name":"SqueezeSignal","description":"Short-squeeze setup signal for a stock (?ticker=<stock ticker>)","url":"https://squeeze.lonestaroracle.xyz/squeeze","method":"GET","headers":{},"bodySchema":{"name":"SqueezeSignal","tags":["short-squeeze","short-interest","equities","trading","risk"],"type":"object","version":"1.0.0","category":"markets","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"ticker":{"type":"string","example":"GME","description":"Stock ticker to screen for squeeze risk (e.g. GME, BYND, CVNA). Aliases: symbol."}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"state":"coiled","source":"yfinance (FINRA short interest + price)","ticker":"GME","company":"GameStop Corporation","drivers":["short interest 13.5% of float (high)","days-to-cover 12.8 (crowded, slow to exit)"],"metrics":{"price":19.1,"shares_short":55426276,"days_to_cover":12.78,"fifty_day_avg":21.78,"vs_50d_avg_pct":-12.4,"short_pct_float":13.54,"short_interest_trend":"flat"},"max_score":10,"squeeze_score":5,"interpretation":"Notable short-squeeze conditions — heavily shorted but still falling; fuel is building, not yet lit.","squeeze_signal":"ELEVATED"}}}},"description":"Short-squeeze detection made agent-callable. One x402 call takes a stock ticker and returns a squeeze-risk signal (HIGH / ELEVATED / MODERATE / LOW) built from short interest as a percent of float and days-to-cover, plus a state read (coiled = heavily shorted but still falling / igniting = heavily shorted AND rising / primed / quiet) that blends price momentum vs the 50-day average with the short-interest trend. Names the drivers (e.g. 'short interest 25.7% of float', 'days-to-cover 12.8', 'price 9% above its 50-day avg'). What a trading or risk agent needs to flag squeeze setups, pay-per-call. $0.05 in USDC on Base via x402. Source: yfinance (FINRA short interest + price; free/public). NOTE: short interest is bi-monthly and ~2 weeks lagged, and this does NOT include real-time borrow fee / share utilization (paid data, e.g. Ortex/S3) — the strongest squeeze predictors. Companion to EquityScope, OptionsFlow and AnalystEdge."},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yTdiS55Y8osWQ7W7BMfav","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a short-squeeze risk signal (HIGH/ELEVATED/MODERATE/LOW), squeeze state, score, and key drivers for a given stock ticker","exampleAgentPrompt":"What's the short-squeeze risk signal for GameStop (GME) right now — is it coiled, igniting, or quiet, and what are the main drivers like short interest and days-to-cover?","exampleUseCases":[{"title":"Pre-trade squeeze risk check","prompt":"Before I buy into CVNA, can you pull the short-squeeze signal for it? I want to know if it's heavily shorted, what the days-to-cover looks like, and whether the squeeze state is coiled or igniting."},{"title":"Meme stock momentum screening","prompt":"Check the squeeze signal for AMC and tell me the squeeze score, what signal level it's at — HIGH, ELEVATED, MODERATE, or LOW — and what the key drivers are."},{"title":"Risk flagging for short position","prompt":"I'm thinking about shorting BYND — can you check if it has dangerous short-squeeze conditions? I need to see the short interest as a percent of float, days-to-cover, and the overall squeeze state."}],"resultDescription":"Returns a JSON object with: squeeze_signal (HIGH/ELEVATED/MODERATE/LOW), squeeze_score (0–10), squeeze_state (coiled/igniting/primed/quiet), company name, ticker, key driver strings explaining the conditions, and underlying metrics including short_pct_float, days_to_cover, price, vs_50d_avg_pct, shares_short, and short_interest_trend. Also includes the data source (yfinance/FINRA) and an interpretation sentence.","failureModes":["Invalid or unknown ticker returns an error or empty result","Data may be stale — short interest is bi-monthly and approximately 2 weeks lagged","Tickers not covered by FINRA/yfinance (e.g. OTC pink sheets) may return incomplete data","Payment failure via x402 if insufficient USDC balance on Base","Rate limiting or upstream yfinance downtime causing failed data fetch"],"whenToPreferThis":"Choose this endpoint when an agent needs a fast, structured squeeze-risk verdict for a single equity ticker, especially for meme stocks or names with known heavy short interest. It is ideal for pre-trade screening, risk flagging for existing short positions, or surfacing squeeze setups in a watchlist workflow. Prefer it over general financial data APIs when the specific output needed is squeeze state classification plus driver explanation, rather than raw price or fundamental data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:52.264Z","isFirstParty":false}