# SEC Fails-to-Deliver Data API

> SEC Fails-to-Deliver Data API is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns up to 120 days of daily SEC fails-to-deliver data for a US stock, including share counts, value, percentage of shares outstanding, and Reg SHO threshold pattern classification.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/sec/fails-to-deliver/GME?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-fails-to-deliver-data-api-ef286e2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F9kYxs1MW-QgRvWQBhLsE

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 sec-fails-to-deliver-data-api-ef286e2b
```

Example prompt: Before I short GME, pull the last 120 days of SEC fails-to-deliver data for it and tell me if it's showing a THRESHOLD_LIKE or PERSISTENT_FAILS pattern.

## When to prefer this

Use this endpoint when you need regulatory-grade, SEC-sourced fails-to-deliver data specifically for evaluating short squeeze risk, naked shorting signals, or Reg SHO threshold status. Prefer it over general market data endpoints when the specific FTD count, value, and threshold pattern classification are required for a trade decision.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty result
- Data may lag SEC publication schedule by 1-2 days
- Tickers with very low FTD activity may return sparse records
- Non-US stocks or OTC tickers not covered by SEC FTD program may return no data
- Payment failure (x402) prevents access to data

## How this service works

Use before shorting or chasing a squeeze ($0.005): daily fails-to-deliver of a US stock from SEC data (up to 120 days), value, share of shares outstanding and the Reg SHO threshold pattern (10,000 shares and 0.5% for 5 days in a row) as a signal: THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS, OCCASIONAL_FAILS.

## Output

Returns a time series of up to 120 daily records for the requested ticker, each containing: date, number of shares failed to deliver, dollar value of fails, percentage of shares outstanding that failed, and a Reg SHO-style pattern classification label (THRESHOLD_LIKE, RECENT_THRESHOLD_LIKE, PERSISTENT_FAILS, or OCCASIONAL_FAILS).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "examples": [
        "GME"
       ],
       "description": "Any US ticker in the SEC fails-to-deliver files (17,000+, e.g. GME, AMC, TSLA). Unknown: 404, not charged."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "default": 90,
       "maximum": 120,
       "minimum": 5,
       "description": "Look-back period in days"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "description": "Example JSON response returned by this endpoint"
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-fails-to-deliver-data-api-ef286e2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)