{"uid":"cap_bTKFCCplhuWtzlJThnzyt","slug":"x402stock-short-squeeze-score-api-49e9553d","name":"x402stock Short Squeeze Score API","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/score/squeeze/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-06-08T12:00:00.000Z","score":{"max":100,"label":"elevated","value":68,"factors":[{"max":30,"name":"short_interest_pct","unit":"%","label":"Short interest vs shares outstanding","score":18,"value":12.4},{"max":25,"name":"days_to_cover","unit":"days","label":"Days to cover","score":15,"value":5.2},{"max":20,"name":"short_volume_ratio","unit":"%","label":"Daily short-volume ratio","score":11,"value":46.1},{"max":15,"name":"fails_to_deliver","unit":"%","label":"Fails-to-deliver vs ADV","score":6,"value":0.9},{"max":10,"name":"spark","unit":"%chg","label":"Price momentum + social attention","score":8,"value":4.3}],"confidence":1},"inputs":{"short_interest":22500000,"day_change_percent":4.3,"shares_outstanding":181000000,"short_volume_ratio":46.1,"days_to_cover_rising":true},"source":"x402stock","ticker":"GME","sections":{"short_volume":"ok","short_interest":"ok","fails_to_deliver":"ok"},"rationale":"GME scores 68/100 (elevated) for short-squeeze pressure. Biggest contributor: days to cover (15/25). Days to cover 5.2 and rising. Short interest ≈ 12.4% of shares. Currently trending on retail forums.","disclaimer":"Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting.","methodology":"Weighted 5-factor gauge: short interest %-of-shares (30) + days-to-cover (25) + daily short-volume ratio (20) + fails-to-deliver vs ADV (15) + price/social spark (10). Higher = more squeeze pressure."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MI_cLPE6gRw_doE65cChh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a weighted 5-factor short-squeeze pressure score (0-100) for a given US stock ticker, including sub-scores for short interest, days to cover, short volume ratio, fails-to-deliver, and price/social momentum.","exampleAgentPrompt":"What's the current short squeeze score for GME — give me the full breakdown including days to cover, short interest percentage, and the rationale?","exampleUseCases":[{"title":"Meme stock squeeze risk check","prompt":"Can you pull up the full short squeeze breakdown for AMC right now? I want to see the pressure score, days to cover, short interest percentage, and whatever rationale the data gives — basically tell me if a squeeze looks likely."},{"title":"Pre-trade short pressure analysis","prompt":"Before I take a position on BBBY, give me a quantitative short squeeze assessment — I need the composite score, all five sub-factor scores, and a plain-English explanation of what the data is saying about squeeze risk."},{"title":"Compare squeeze pressure on TSLA","prompt":"Is there elevated short squeeze pressure on TSLA at the moment? Walk me through the squeeze score, the short volume ratio, fails-to-deliver numbers, and how confident the model is in its reading."}],"resultDescription":"A JSON object with a composite squeeze score (0-100) with a label (e.g. 'elevated'), five sub-factor scores (short interest %, days to cover, short volume ratio, fails-to-deliver, price/social spark), a plain-English rationale, confidence level, methodology explanation, and a disclaimer. Includes the raw input values used and a data-freshness timestamp.","failureModes":["Unknown or invalid ticker returns an error or empty result","Ticker exists but insufficient data for one or more factors reduces confidence score","Stale data if short interest reporting lags (periodic, not real-time)","Non-US or OTC tickers may not be supported","Payment failure via x402/USDC blocks the request"],"whenToPreferThis":"Use this endpoint when you need a structured, quantitative squeeze-pressure gauge for a specific US equity, especially for high-short-interest or meme stocks. Prefer this over generic quote APIs when the user's question is specifically about short-squeeze risk, short interest levels, days-to-cover, or retail squeeze momentum rather than price, fundamentals, or earnings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:56:56.472Z","isFirstParty":false}