# x402stock Fails-to-Deliver by Ticker

> x402stock Fails-to-Deliver by Ticker is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns SEC EDGAR fails-to-deliver data for a given US stock ticker, showing aggregate net shares that failed to deliver on settlement dates.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/fails-to-deliver/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-fails-to-deliver-by-ticker-41717175
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N7ih9Kp9IahpMdKvDOk5n

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-fails-to-deliver-by-ticker-41717175
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-fails-to-deliver-by-ticker-41717175/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)