{"uid":"cap_uIRNngUqiGcB0hv8-_EEx","slug":"agents-x402stock-xyz-x402stock-short-interest-history-b6e9090b","name":"x402stock Short Interest History","description":"Returns bi-weekly short interest and days-to-cover for a stock.","url":"https://agents.x402stock.xyz/api/v1/short-interest/{ticker}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":12,"maximum":100,"exclusiveMinimum":0},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["count","latest","history"],"properties":{"count":{"type":"number"},"latest":{"type":"object","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"}],"properties":{"days_to_cover":{"type":"number"},"short_interest":{"type":"number"},"settlement_date":{"type":"string"},"avg_daily_volume":{"type":"number"}}},"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JFE0lSmF2VK_0Ziei8Smg","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns bi-weekly FINRA exchange-reported short interest history for a US-listed stock, including shares sold short, average daily volume, and days-to-cover.","exampleAgentPrompt":"Pull the last 8 FINRA settlement periods of short interest history for GME — I want to see shares sold short, average daily volume, and days-to-cover to assess short squeeze potential.","exampleUseCases":[{"title":"Short squeeze signal detection","prompt":"Show me the last 12 short interest settlement periods for GME, including days-to-cover and average daily volume — I want to see if a short squeeze setup is building."},{"title":"Bearish positioning trend for earnings play","prompt":"What's the short interest history for NVDA over the past 6 FINRA settlements? I need shares sold short and days-to-cover to gauge bearish sentiment ahead of earnings."},{"title":"Portfolio risk monitoring for shorted holdings","prompt":"Fetch the recent short interest data for TSLA going back about 10 settlements so I can track whether short sellers are increasing or unwinding their positions."}],"resultDescription":"A JSON object containing the ticker, a data block with count of settlements returned, the latest settlement record (settlement date, shares short, avg daily volume, days-to-cover), and a history array of those same fields ordered most-recent-first, plus a source label and as-of timestamp.","failureModes":["Invalid or unlisted ticker symbol returns an error or empty data","Limit parameter outside 1–100 range is rejected","Ticker with no FINRA short interest data returns null for latest and empty history array","Payment failure via x402/USDC blocks the request","Rate limiting or proxy errors return 402 or 5xx responses"],"whenToPreferThis":"Use this endpoint when you need exchange-reported FINRA short interest data with bi-weekly settlement granularity for any US-listed stock, specifically when days-to-cover or trend analysis of short positioning is required. It is the right choice over generic market data endpoints because it provides the authoritative semi-monthly FINRA figures rather than estimated or inferred short interest, and supports configurable history depth via the limit parameter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:49:43.904Z","isFirstParty":false,"canonicalSlug":"x402stock-short-interest-history-88916a31"}