---
title: "Market fails-to-deliver leaderboard (latest SEC period)"
method: GET
path: "/api/v1/short-side/fails-to-deliver"
tags: ["Finance"]
---

# Market fails-to-deliver leaderboard (latest SEC period)

`GET /api/v1/short-side/fails-to-deliver`

Top fails-to-deliver across the market for the most recent SEC reporting period, ranked by failed-share quantity descending. A fail-to-deliver (FTD) is a settlement fail: the seller did not deliver the shares to the buyer by the settlement date. Persistent or spiking fails for a ticker are read as a short-squeeze / settlement-risk signal. Note the pre/post 2008-09-16 threshold discontinuity: before that date the SEC published only fail balances of 10,000 shares or more, so early history undercounts smaller fails and is not directly comparable with the later full series. Source: U.S. Securities and Exchange Commission.

## Response `200`

Latest-period top fails-to-deliver leaderboard.

- EnvelopeFailsToDeliverMarketData
  - `data` FailsToDeliverMarketData, required
    - `latest_period` string, required — Most recent SEC FTD reporting period (e.g. 202605b).
    - `latest_settlement_date` string, required — Latest settlement date covered (YYYY-MM-DD).
    - `symbol_count` integer, required — Number of distinct symbols in the latest period.
    - `count` integer, required — Number of rows in top_fails.
    - `top_fails` FailsToDeliverTopRecord[], required — Top fails of the latest period, by quantity descending.
      - `symbol` string, required — Security ticker symbol.
      - `cusip` string, required — CUSIP identifier the fail was reported under.
      - `date` string, required — Settlement date (YYYY-MM-DD).
      - `quantity` integer, required — Total shares that failed to deliver.
      - `description` string, required — Security description as reported by the SEC.
      - `price` number, nullable — Closing price on the prior day, as reported by the SEC. May be null.
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header.
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4e2740743eb4/schema)