{"uid":"cap_7zVyWgN8skSE-XaN4IEpQ","slug":"agents-x402stock-xyz-x402stock-short-squeeze-composite-for-us-stocks-508bbaa4","name":"x402stock Short-Squeeze Composite for US Stocks","description":"The short-squeeze picture for a US stock in one call: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, and settlement fails-to-deliver, plus a computed signal pulling the headline gauges together. Replaces three separate calls (short-interest + short-volume + fails-to-deliver) at a lower combined price. Sections degrade independently. From x402stock","url":"https://agents.x402stock.xyz/api/v1/squeeze/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","source","as_of","sections","signal","short_interest","short_volume","fails_to_deliver"],"properties":{"as_of":{"type":"string"},"signal":{"anyOf":[{"type":"object","required":["days_to_cover","short_interest","short_volume_ratio"],"properties":{"days_to_cover":{"anyOf":[{"type":"number"},{"type":"null"}]},"short_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"short_volume_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"short_volume":{"anyOf":[{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["count","latest","history"],"properties":{"count":{"type":"number"},"latest":{"anyOf":[{"type":"object","required":["date","total_volume","short_volume","exempt_volume","non_exempt_volume","short_volume_ratio","venues"],"properties":{"date":{"type":"string"},"venues":{"type":"object","required":["nyse","nasdaq_carteret","nasdaq_chicago","adf"],"properties":{"adf":{"anyOf":[{"type":"number"},{"type":"null"}]},"nyse":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_chicago":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"short_volume":{"type":"number"},"total_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","required":["date","total_volume","short_volume","exempt_volume","non_exempt_volume","short_volume_ratio","venues"],"properties":{"date":{"type":"string"},"venues":{"type":"object","required":["nyse","nasdaq_carteret","nasdaq_chicago","adf"],"properties":{"adf":{"anyOf":[{"type":"number"},{"type":"null"}]},"nyse":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_chicago":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"short_volume":{"type":"number"},"total_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},{"type":"null"}]},"short_interest":{"anyOf":[{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["count","latest","history"],"properties":{"count":{"type":"number"},"latest":{"anyOf":[{"type":"object","required":["settlement_date","short_interest","avg_daily_volume","days_to_cover"],"properties":{"days_to_cover":{"type":"number"},"short_interest":{"type":"number"},"settlement_date":{"type":"string"},"avg_daily_volume":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","required":["settlement_date","short_interest","avg_daily_volume","days_to_cover"],"properties":{"days_to_cover":{"type":"number"},"short_interest":{"type":"number"},"settlement_date":{"type":"string"},"avg_daily_volume":{"type":"number"}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},{"type":"null"}]},"fails_to_deliver":{"anyOf":[{"type":"object","required":["source","as_of","symbol","periods_read","count","note","fails"],"properties":{"note":{"type":"string"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"count":{"type":"number"},"fails":{"type":"array","items":{"type":"object","required":["settlement_date","cusip","symbol","fails","description","price"],"properties":{"cusip":{"anyOf":[{"type":"string"},{"type":"null"}]},"fails":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"symbol":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"settlement_date":{"type":"string"}},"additionalProperties":false}},"source":{"type":"string","const":"sec_edgar"},"symbol":{"type":"string"},"periods_read":{"type":"number"}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.04","displayCostAsset":"USD","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.04/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YUkQADBsVrrrwH9DMzX6Y","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns a combined short-squeeze picture for a US stock: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, settlement fails-to-deliver, and a computed composite signal.","exampleAgentPrompt":"Pull the full short-squeeze picture for GME — short interest with days-to-cover, daily short-volume ratio, fails-to-deliver, and the composite signal — all in one shot.","exampleUseCases":[{"title":"Meme stock squeeze alert monitoring","prompt":"Check the short-squeeze composite signal for GME — I want to see the short interest, days-to-cover, short-volume ratio, and any fails-to-deliver to figure out if a squeeze could be building."},{"title":"Hedge fund short pressure research","prompt":"Give me the full short-squeeze breakdown for NVDA: bi-weekly short interest, daily short-sale volume ratio, settlement fails-to-deliver, and the headline composite signal."},{"title":"Retail trader due diligence on a volatile stock","prompt":"Before I buy AMC options, can you pull the short-squeeze data — short interest days-to-cover, short volume ratio, and FTDs — and tell me what the computed signal says about squeeze risk?"}],"resultDescription":"A JSON object containing: the ticker and data timestamp; a 'sections' map indicating status of each sub-dataset; a 'signal' object with headline composite gauges (days_to_cover, short_interest, short_volume_ratio); full short_interest history with days-to-cover per period; full short_volume history with per-venue breakdown and short_volume_ratio per day; and fails_to_deliver aggregate data. Sections degrade independently if a sub-source is unavailable.","failureModes":["Unknown or delisted ticker returns empty or null sections","FINRA/SEC data may lag by several days, so 'as_of' may not be today","Individual sections (short_interest, short_volume, fails_to_deliver) can be null if source data is unavailable, while others succeed","Non-US or OTC-only tickers may return partial or empty data","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need a complete short-squeeze picture for a US stock in a single call and want to avoid paying for three separate endpoints (short-interest, short-volume, fails-to-deliver). It is cheaper combined and gives a pre-computed composite signal, making it ideal for screening, alerting, or research workflows where all three dimensions of short pressure matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:47:07.647Z","isFirstParty":false}