# x402stock Fails-to-Deliver

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

Returns SEC semi-monthly fails-to-deliver data for a US-listed stock ticker, showing aggregate undelivered shares and reference price per settlement date, most recent first.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/fails-to-deliver/:ticker?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-fails-to-deliver-ca9d77d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9JsfZhbLNXCgKAb74sZG_

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-ca9d77d5
```

Example prompt: Pull the last 60 fails-to-deliver records from SEC EDGAR for GME — I want to see the settlement dates, how many shares failed to deliver, and the reference price to gauge short squeeze pressure.

## When to prefer this

Choose this endpoint when you need official SEC EDGAR fails-to-deliver data for a specific US-listed stock as a niche short-pressure or potential squeeze signal. It is the right choice when you want authoritative regulatory settlement failure counts rather than derived short-interest estimates or borrow-rate proxies. Prefer this over generic financial data APIs when the specific SEC semi-monthly FTD series is required.

## Known failure modes

- Unknown or invalid ticker returns empty results or 404
- Limit parameter out of range (must be 1–120) returns validation error
- Periods parameter out of range (must be 1–6) returns validation error
- SEC EDGAR source data lag may mean the most recent semi-monthly period is not yet available
- Payment failure via x402 (insufficient USDC balance or unsupported wallet) blocks the request

## 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 list of semi-monthly settlement records for the requested ticker, each containing the settlement date, the aggregate number of shares that failed to deliver, and the reference price on that date. Records are returned most recent first, up to the requested limit (default 30, max 120), spanning up to the requested number of semi-monthly periods.

## 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"
    },
    "pathParams": {
     "type": "object",
     "ticker": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 30,
       "maximum": 120,
       "exclusiveMinimum": 0
      },
      "periods": {
       "type": "integer",
       "default": 2,
       "maximum": 6,
       "exclusiveMinimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-fails-to-deliver-ca9d77d5/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)