{"uid":"cap_F9kYxs1MW-QgRvWQBhLsE","slug":"sec-fails-to-deliver-data-api-ef286e2b","name":"SEC Fails-to-Deliver Data API","description":"Use before shorting or chasing a squeeze ($0.005): daily fails-to-deliver of a US stock from 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.","url":"https://api.marketintelligenceapi.com/api/v1/sec/fails-to-deliver/GME?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":["GME"],"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_6XvnmduWQQ8P3Mtj3gYDw","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 up to 120 days of daily SEC fails-to-deliver data for a US stock, including share counts, value, percentage of shares outstanding, and Reg SHO threshold pattern classification.","exampleAgentPrompt":"Before I short GME, pull the last 120 days of SEC fails-to-deliver data for it and tell me if it's showing a THRESHOLD_LIKE or PERSISTENT_FAILS pattern.","exampleUseCases":[{"title":"Short squeeze risk assessment","prompt":"I'm thinking of going long on AMC because of chatter about a squeeze — can you pull the SEC fails-to-deliver history for AMC and tell me if it meets the Reg SHO threshold pattern or has persistent fails?"},{"title":"Pre-short due diligence check","prompt":"Before I put on a short position in BBBY, check the SEC FTD data and let me know the daily fail counts, what percentage of shares outstanding they represent, and whether the pattern is classified as THRESHOLD_LIKE or something else."},{"title":"Monitoring FTD trends for watchlist","prompt":"Pull the fails-to-deliver data for TSLA over the past 120 days and summarize whether the pattern has been occasional, persistent, or recently spiking toward threshold levels."}],"resultDescription":"Returns a time series of up to 120 daily records for the requested ticker, each containing: date, number of shares failed to deliver, dollar value of fails, percentage of shares outstanding that failed, and a Reg SHO-style pattern classification label (THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS, or OCCASIONAL_FAILS).","failureModes":["Invalid or unknown ticker symbol returns an error or empty result","Data may lag SEC publication schedule by 1-2 days","Tickers with very low FTD activity may return sparse records","Non-US stocks or OTC tickers not covered by SEC FTD program may return no data","Payment failure (x402) prevents access to data"],"whenToPreferThis":"Use this endpoint when you need regulatory-grade, SEC-sourced fails-to-deliver data specifically for evaluating short squeeze risk, naked shorting signals, or Reg SHO threshold status. Prefer it over general market data endpoints when the specific FTD count, value, and threshold pattern classification are required for a trade decision.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:32:13.616Z","isFirstParty":false,"canonicalSlug":"sec-fails-to-deliver-data-api-ef286e2b"}