{"uid":"cap_N7ih9Kp9IahpMdKvDOk5n","slug":"x402stock-fails-to-deliver-by-ticker-41717175","name":"x402stock Fails-to-Deliver by Ticker","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/fails-to-deliver/%7Bticker%7D","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["limit","periods"],"properties":{"limit":{"type":"integer","default":30,"maximum":120,"exclusiveMinimum":0},"periods":{"type":"integer","default":2,"maximum":6,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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}}}}},"responseSchema":{"type":"json","example":{"note":"QUANTITY (FAILS) is the aggregate net balance of shares that failed to deliver as of the settlement date.","as_of":"2026-04-30T00:00:00.000Z","count":1,"fails":[{"cusip":"36467W109","fails":124500,"price":24.13,"symbol":"GME","description":"GAMESTOP CORP","settlement_date":"2026-04-30"}],"source":"sec_edgar","symbol":"GME","periods_read":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8WWBtN55cTNJA8Q9OnPfD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns SEC EDGAR fails-to-deliver data for a given US stock ticker, showing aggregate net shares that failed to deliver on settlement dates.","exampleAgentPrompt":"Pull the fails-to-deliver data for GME from SEC EDGAR — give me the last 2 reporting periods with up to 30 records so I can see how many shares failed to settle.","exampleUseCases":[{"title":"Identify short squeeze candidates","prompt":"Check the SEC fails-to-deliver data for AMC — I want to see the most recent periods to find out how many shares are failing to settle and whether it looks like a potential short squeeze setup."},{"title":"Audit settlement failures for compliance","prompt":"Pull the EDGAR fails-to-deliver history for BBBY so I can review aggregate net shares that didn't settle on time — I need this for a regulatory compliance report I'm putting together."},{"title":"Research naked short selling activity","prompt":"Look up the SEC FTD records for KOSS and give me the last few reporting periods — I'm trying to figure out how much naked short selling activity there's been based on the failed delivery quantities and prices."}],"resultDescription":"A JSON object containing: the source (sec_edgar), the ticker symbol, an as_of timestamp, the number of periods read, total count of records, a note explaining the FTD quantity metric, and an array of fails records each with settlement_date, CUSIP, symbol, description, fails quantity (aggregate net shares), and price per share.","failureModes":["Invalid or unknown ticker symbol returns empty fails array or error","limit parameter out of range (<=0 or >120) causes validation error","periods parameter out of range (<=0 or >6) causes validation error","Payment failure via x402/USDC results in 402 Payment Required response","SEC EDGAR data unavailable or delayed returns null as_of or empty dataset","Ticker with no FTD history returns count:0 with empty fails array"],"whenToPreferThis":"Use this endpoint when you need official SEC EDGAR fails-to-deliver data for a specific US equity ticker, particularly for analyzing short squeeze candidates, settlement failures, or regulatory compliance research. Prefer this over general market data endpoints when the specific metric needed is FTD quantity rather than price, volume, or short interest.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:56:52.413Z","isFirstParty":false}