{"uid":"cap_Wnb09Szq0h1sfXaF9nXlO","slug":"finra-short-interest-lookup-e23a0b6c","name":"FINRA Short Interest Lookup","description":"FINRA short interest for a US stock — shares sold short, days-to-cover and average volume, a short-squeeze sentiment signal.","url":"https://marketdata.use.x402atlas.com/short-interest","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","maximum":50000,"minimum":1,"description":"Max results returned"},"ticker":{"type":"string","description":"US stock ticker, e.g. AAPL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","ticker","count","records"],"properties":{"count":{"type":"integer","description":"Number of records returned."},"ticker":{"type":"string","description":"Echo of the requested ticker."},"records":{"type":"array","items":{"type":"object","required":["short_interest"],"properties":{"days_to_cover":{"type":"number","description":"short_interest / avg_daily_volume."},"short_interest":{"type":"integer","description":"Total shares sold short."},"settlement_date":{"type":"string","format":"date"},"avg_daily_volume":{"type":"integer"}}},"description":"FINRA bi-weekly short-interest history, most recent first."},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp when this bridge queried the upstream."}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"ticker":"A","records":[{"days_to_cover":1.67,"short_interest":3906231,"settlement_date":"2025-03-14","avg_daily_volume":2340158}],"queried_at":"2026-07-06T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6NxFHq9_8cxK6KahoKMR5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns FINRA short interest data for a US stock ticker, including shares sold short, days-to-cover ratio, and average volume as a short-squeeze sentiment signal.","exampleAgentPrompt":"What's the current FINRA short interest for GameStop (GME) — I want to know the shares sold short, days-to-cover, and whether it looks like a short squeeze candidate?","exampleUseCases":null,"resultDescription":"Returns FINRA-sourced short interest data for the requested US stock ticker, including the number of shares currently sold short, the days-to-cover ratio (short interest divided by average daily volume), and average trading volume — providing a quantitative short-squeeze sentiment signal.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Non-US ticker symbols may not be covered by FINRA data","Limit parameter exceeds maximum of 50000 returns a validation error","Service unavailable or payment failure returns a 402 or 5xx error","Stale data if FINRA has not yet published the latest reporting period"],"whenToPreferThis":"Use this endpoint when you need official FINRA-sourced short interest metrics for a specific US-listed stock, particularly for short-squeeze analysis, sentiment gauging, or fundamental research. Prefer this over FINRA daily short-sale volume endpoints when you need cumulative short interest position data (shares outstanding short) rather than single-day short volume. Best for equities-focused agents doing market research, risk assessment, or trading signal generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:10.453Z","isFirstParty":false}