{"uid":"cap_FFCYw_Q7q93mVtLt0wHn-","slug":"sec-fails-to-deliver-data-for-us-stocks-58c34847","name":"SEC Fails-to-Deliver Data for US Stocks","description":"Fails to deliver of a US stock ($0.005): daily SEC data (up to 120 days), value, share of shares outstanding and the Reg SHO threshold pattern (10,000 shares and 0.5% for 5 days in a row) as a signal - THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS, OCCASIONAL_FAILS. Use before shorting or chasing a squeeze.","url":"https://api.marketintelligenceapi.com/api/v1/sec/fails-to-deliver/:symbol?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","examples":["AAPL"],"description":"Any US ticker in the SEC fails-to-deliver files (17,000+, e.g. GME, AMC, TSLA). Unknown: 404, not charged."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"days":{"type":"integer","default":90,"maximum":120,"minimum":5,"description":"Look-back period in days"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DItG6lMYhvns6l33-6XpD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily SEC fails-to-deliver data for a US stock ticker, including share counts, value, share of outstanding, and Reg SHO threshold pattern signals.","exampleAgentPrompt":"Pull up the SEC fails-to-deliver data for GME over the last 90 days — I want to see the daily FTD counts, their value, what percentage of shares outstanding they represent, and whether there's a Reg SHO threshold pattern flagged.","exampleUseCases":[{"title":"Pre-short due diligence on a stock","prompt":"Before I short BBBY, can you grab the SEC fails-to-deliver history for the last 60 days and tell me if it's showing any PERSISTENT_FAILS or threshold pattern signals?"},{"title":"Identifying short squeeze candidates","prompt":"I'm hunting for short squeeze setups — pull the FTD data for AMC over the past 120 days and let me know if it's hitting the Reg SHO threshold pattern, like THRESHOLD_LIKE or RECENT_THRESHOLD_LIKE."},{"title":"Monitoring ongoing FTD pattern for a watchlist stock","prompt":"Check the latest fails-to-deliver data for TSLA — specifically whether the FTD share as a percentage of outstanding has been climbing and if there's any squeeze signal flagged in the last 30 days."}],"resultDescription":"Returns up to 120 days of daily SEC fails-to-deliver records for the requested ticker, including: raw FTD share count, dollar value of fails, FTDs as a percentage of total shares outstanding, and a classified Reg SHO signal pattern — one of THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS, or OCCASIONAL_FAILS. Returns 404 (not charged) for unknown tickers.","failureModes":["404 returned for unknown or unsupported ticker symbols (not charged)","Ticker not in SEC FTD files (covers 17,000+ US tickers but not all symbols)","Requested days parameter outside 5–120 range causes validation error","Stale data if SEC has not yet published the most recent settlement cycle","Payment failure if USDC balance is insufficient for the $0.01 per-call fee"],"whenToPreferThis":"Use this endpoint when you need SEC-sourced, authoritative fails-to-deliver data for a specific US stock with Reg SHO threshold pattern classification built in. Prefer it over generic financial data APIs when the use case involves short-selling research, squeeze signal detection, or regulatory compliance checks — especially when you want a pre-computed pattern label (THRESHOLD_LIKE, PERSISTENT_FAILS, etc.) rather than raw FTD numbers alone.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:40:43.906Z","isFirstParty":false,"canonicalSlug":"sec-fails-to-deliver-data-for-us-stocks-58c34847"}