{"uid":"cap_wZaxIhk-OnKu_Ebu1Bybv","slug":"agents-x402stock-xyz-sec-fails-to-deliver-by-ticker-6c9596b7","name":"SEC Fails-to-Deliver by Ticker","description":"Settlement fails-to-deliver for a US-listed stock from the SEC's semi-monthly data: the aggregate shares that failed to deliver on each settlement date, with the reference price, most recent first. A niche short-pressure and squeeze signal. ?limit= records (default 30). Sourced from SEC EDGAR. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.","url":"https://agents.x402stock.xyz/api/v1/fails-to-deliver/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":30,"maximum":120,"exclusiveMinimum":0},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."},"periods":{"type":"integer","default":2,"maximum":6,"exclusiveMinimum":0}}},"responseSchema":{"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},"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_Qd1rxDW-0uelg0-ccfQve","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-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns SEC EDGAR semi-monthly fails-to-deliver data for a US-listed stock, showing aggregate shares that failed to settle on each settlement date with reference price, most recent first.","exampleAgentPrompt":"Pull up the SEC fails-to-deliver history for GME — give me the last 60 records across 3 reporting periods so I can see how much short-squeeze pressure has been building.","exampleUseCases":[{"title":"Meme stock squeeze signal monitoring","prompt":"Show me the fails-to-deliver data from the SEC for AMC over the last 4 reporting periods — I want to see if FTDs have been spiking recently as a potential squeeze signal."},{"title":"Short pressure research for a thesis","prompt":"I'm building a short-squeeze watchlist — can you fetch the SEC EDGAR fails-to-deliver records for BBBY with up to 90 entries so I can see the trend in settlement failures?"},{"title":"Due diligence on heavily shorted stock","prompt":"Before I take a position in KOSS, pull the most recent SEC fails-to-deliver data for it — I want to see the aggregate shares and reference prices from the last couple of reporting periods."}],"resultDescription":"A JSON object containing the source (sec_edgar), the as-of date, the ticker symbol, number of SEC reporting periods read, total record count, a note, and an array of fail records each with settlement_date, CUSIP, symbol, description, aggregate fails (shares), and reference price — sorted most recent first.","failureModes":["Unknown or invalid ticker returns empty fails array or error","SEC EDGAR data may lag by several weeks from actual settlement dates","limit or periods exceeds maximum returns 400 validation error","No FTD data available for thinly traded or OTC-only securities","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need official SEC-sourced fails-to-deliver data for a specific US-listed stock to assess short-pressure, squeeze risk, or settlement anomalies. Prefer it over broker-reported short interest data when you want regulatory-grade settlement failure counts from EDGAR's semi-monthly releases. Best suited for analyzing individual tickers rather than broad market scans.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:09.326Z","isFirstParty":false}