# SEC Fails-to-Deliver by Ticker

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

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.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/fails-to-deliver/{ticker}
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-sec-fails-to-deliver-by-ticker-6c9596b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wZaxIhk-OnKu_Ebu1Bybv

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 agents-x402stock-xyz-sec-fails-to-deliver-by-ticker-6c9596b7
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

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