SEC filings & market structure

Fails-to-Deliver

Returns SEC Fails-to-Deliver (FTD) rows — daily settlement failures by ticker / CUSIP / date. Each row is one ticker on one settlement date where a clearing-member's short sale FAILED to deliver shares.

EndpointGET /v1/sec-fails-to-deliver

SourceSEC Fails-to-Deliver

Authx-api-key — a free key works

What it returns

One record per result. Fields (from a live response):

Subject — cusip, ticker, description
Dates — year_month, settlement_date, scraped_at
Amounts — fail_value, price, quantity_fails
Provenance — source_url
Details — id

Filters

id	Direct doc lookup ({YYYY-MM-DD}-{cusip}). Fastest path.
ticker	Ticker symbol (uppercased automatically).
cusip	Exact CUSIP (preferred for foreign issuers / class shares).
since	Inclusive lower bound on settlement_date (YYYY-MM-DD).
until	Inclusive upper bound on settlement_date (YYYY-MM-DD).
min_quantity	Inclusive lower bound on quantity_fails (shares). E.g., 100000 surfaces only large failures.
min_value	Inclusive lower bound on fail_value (dollars). E.g., 1000000 surfaces only $1M+ failures.
sort_by	Sort key. Default: settlement_date.
sort_order	Default: desc.
limit	Max records. Default 50, max 500.

Example request

curl "https://api.keyvex.com/v1/sec-fails-to-deliver?ticker=AAPL&limit=1" \
  -H "x-api-key: YOUR_KEY"

Response

{
  "results": [
    {
      "year_month": "2026-05",
      "cusip": "Y9390M103",
      "ticker": "VFS",
      "settlement_date": "2026-05-14",
      "fail_value": 5110.32,
      "price": 3.98,
      "quantity_fails": 1284,
      "description": "VINFAST AUTO LTD. ORDINARY SHA",
      "id": "2026-05-14-Y9390M103",
      "source_url": "https://www.sec.gov/files/data/fails-deliver-data",
      "scraped_at": "2026-06-16T09:00:04.731Z"
    }
  ],
  "count": 1,
  "has_more": true
}

Example questions you can answer

Fails-to-deliver volume for a ticker over time.
Securities with the highest recent FTD counts.

Related datasets

Insider TransactionsSEC Form 4 / 5 insider buys and sells.Planned Insider SalesSEC Form 144 Institutional Holdings (13F)SEC Form 13F Activist Stakes (13D / 13G)SEC Schedule 13D / 13G

Query Fails-to-Deliver from your AI

Hand any AI your key + the OpenAPI spec and it can pull this dataset directly. Free key = full data, 60 requests/day.

Get a free key OpenAPI spec → REST docs →

← All 60+ datasets