GET/api/v1/short-interest/{ticker}$0.02

Bi-weekly short interest and days-to-cover for a stock

The exchange-reported short-interest history for a US-listed stock: total shares sold short, average daily volume, and days-to-cover for each bi-weekly FINRA settlement date, most recent first. A core short-squeeze and bearish-positioning signal. Tune how many settlements to return with `?limit=` (default 12).

Example request

GET /api/v1/short-interest/AAPL

Response type (TypeScript)

interface ShortInterestResponse {
  ticker: string;
  data: {
    count: number;
    latest: {
      settlement_date: string;
      short_interest: number;
      avg_daily_volume: number;
      days_to_cover: number;
    };
    history: Array<{
      settlement_date: string;
      short_interest: number;
      avg_daily_volume: number;
      days_to_cover: number;
    }>;
  };
  source: string;
  as_of: string;
}

Example response (click to expand)

{
  "ticker": "AAPL",
  "data": {
    "count": 6,
    "latest": {
      "settlement_date": "2026-05-15",
      "short_interest": 138782718,
      "avg_daily_volume": 50565316,
      "days_to_cover": 2.74
    },
    "history": [
      {
        "settlement_date": "2026-05-15",
        "short_interest": 138782718,
        "avg_daily_volume": 50565316,
        "days_to_cover": 2.74
      },
      {
        "settlement_date": "2026-04-30",
        "short_interest": 134675274,
        "avg_daily_volume": 45944025,
        "days_to_cover": 2.93
      },
      {
        "settlement_date": "2026-04-15",
        "short_interest": 134422787,
        "avg_daily_volume": 39674165,
        "days_to_cover": 3.39
      },
      {
        "settlement_date": "2026-03-31",
        "short_interest": 126771284,
        "avg_daily_volume": 42873045,
        "days_to_cover": 2.96
      },
      {
        "settlement_date": "2026-03-13",
        "short_interest": 124192030,
        "avg_daily_volume": 38121907,
        "days_to_cover": 3.26
      },
      {
        "settlement_date": "2026-02-27",
        "short_interest": 129553812,
        "avg_daily_volume": 39794651,
        "days_to_cover": 3.26
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-15T00:00:00.000Z"
}

GET/api/v1/short-volume/{ticker}$0.02

Daily short-sale volume and short-volume ratio for a stock

Daily short-sale volume for a US-listed stock: total volume, short volume, exempt and non-exempt short volume, the short-volume ratio, and a per-venue breakdown (NYSE, Nasdaq, ADF), most recent day first. A higher-frequency read on shorting pressure than bi-weekly short interest. Tune with `?limit=` (default 20).

Example request

GET /api/v1/short-volume/AAPL

Response type (TypeScript)

interface ShortVolumeResponse {
  ticker: string;
  data: {
    count: number;
    latest: {
      date: string;
      total_volume: number;
      short_volume: number;
      exempt_volume: number;
      non_exempt_volume: number;
      short_volume_ratio: number;
      venues: {
        nyse: number;
        nasdaq_carteret: number;
        nasdaq_chicago: number;
        adf: number;
      };
    };
    history: Array<{
      date: string;
      total_volume: number;
      short_volume: number;
      exempt_volume: number;
      non_exempt_volume: number;
      short_volume_ratio: number;
      venues: {
        nyse: number;
        nasdaq_carteret: number;
        nasdaq_chicago: number;
        adf: number;
      };
    }>;
  };
  source: string;
  as_of: string;
}

Example response (click to expand)

{
  "ticker": "AAPL",
  "data": {
    "count": 10,
    "latest": {
      "date": "2026-05-29",
      "total_volume": 14864822.80445,
      "short_volume": 6083612.891307,
      "exempt_volume": 164350,
      "non_exempt_volume": 5919262.891307,
      "short_volume_ratio": 40.93,
      "venues": {
        "nyse": 1103183,
        "nasdaq_carteret": 4930548,
        "nasdaq_chicago": 49880,
        "adf": 0
      }
    },
    "history": [
      {
        "date": "2026-05-29",
        "total_volume": 14864822.80445,
        "short_volume": 6083612.891307,
        "exempt_volume": 164350,
        "non_exempt_volume": 5919262.891307,
        "short_volume_ratio": 40.93,
        "venues": {
          "nyse": 1103183,
          "nasdaq_carteret": 4930548,
          "nasdaq_chicago": 49880,
          "adf": 0
        }
      },
      {
        "date": "2026-05-28",
        "total_volume": 15018623.508142,
        "short_volume": 5530909.388436,
        "exempt_volume": 48084,
        "non_exempt_volume": 5482825.388436,
        "short_volume_ratio": 36.83,
        "venues": {
          "nyse": 1168764,
          "nasdaq_carteret": 4320372,
          "nasdaq_chicago": 41772,
          "adf": 0
        }
      },
      {
        "date": "2026-05-27",
        "total_volume": 20717490.359599,
        "short_volume": 11705767.246896,
        "exempt_volume": 33578,
        "non_exempt_volume": 11672189.246896,
        "short_volume_ratio": 56.5,
        "venues": {
          "nyse": 7467219,
          "nasdaq_carteret": 4186330,
          "nasdaq_chicago": 52217,
          "adf": 0
        }
      },
      {
        "date": "2026-05-26",
        "total_volume": 13174731.653709,
        "short_volume": 4775159.922933,
        "exempt_volume": 24407,
        "non_exempt_volume": 4750752.922933,
        "short_volume_ratio": 36.24,
        "venues": {
          "nyse": 227566,
          "nasdaq_carteret": 4493202,
          "nasdaq_chicago": 54391,
          "adf": 0
        }
      },
      {
        "date": "2026-05-22",
        "total_volume": 15322158.123659,
        "short_volume": 7859585.858503,
        "exempt_volume": 67975,
        "non_exempt_volume": 7791610.858503,
        "short_volume_ratio": 51.3,
        "venues": {
          "nyse": 2260425,
          "nasdaq_carteret": 5525431,
          "nasdaq_chicago": 73729,
          "adf": 0
        }
      },
      {
        "date": "2026-05-21",
        "total_volume": 11020225.815672,
        "short_volume": 5388400.001,
        "exempt_volume": 22802,
        "non_exempt_volume": 5365598.001,
        "short_volume_ratio": 48.9,
        "venues": {
          "nyse": 764116,
          "nasdaq_carteret": 4572214,
          "nasdaq_chicago": 52069,
          "adf": 0
        }
      },
      {
        "date": "2026-05-20",
        "total_volume": 12124878.48879,
        "short_volume": 3750645.262622,
        "exempt_volume": 61919,
        "non_exempt_volume": 3688726.262622,
        "short_volume_ratio": 30.93,
        "venues": {
          "nyse": 108699,
          "nasdaq_carteret": 3578798,
          "nasdaq_chicago": 63147,
          "adf": 0
        }
      },
      {
        "date": "2026-05-19",
        "total_volume": 12816897.122638,
        "short_volume": 6146647.560578,
        "exempt_volume": 20908,
        "non_exempt_volume": 6125739.560578,
        "short_volume_ratio": 47.96,
        "venues": {
          "nyse": 268800,
          "nasdaq_carteret": 5839292,
          "nasdaq_chicago": 38554,
          "adf": 0
        }
      },
      {
        "date": "2026-05-18",
        "total_volume": 9691579.407584,
        "short_volume": 3040885.069775,
        "exempt_volume": 65539,
        "non_exempt_volume": 2975346.069775,
        "short_volume_ratio": 31.38,
        "venues": {
          "nyse": 77500,
          "nasdaq_carteret": 2928542,
          "nasdaq_chicago": 34843,
          "adf": 0
        }
      },
      {
        "date": "2026-05-15",
        "total_volume": 16275822.859084,
        "short_volume": 8714049.111124,
        "exempt_volume": 41327,
        "non_exempt_volume": 8672722.111124,
        "short_volume_ratio": 53.54,
        "venues": {
          "nyse": 2421731,
          "nasdaq_carteret": 6196844,
          "nasdaq_chicago": 95473,
          "adf": 0
        }
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T00:00:00.000Z"
}

GET/api/v1/fails-to-deliver/{ticker}$0.02

Fails-to-deliver history for a stock: settlement-fail share volume by date

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.

Example request

GET /api/v1/fails-to-deliver/AAPL

Response type (TypeScript)

interface FailsToDeliverResponse {
  source: string;
  as_of: string;
  symbol: string;
  periods_read: number;
  count: number;
  note: string;
  fails: Array<{
    settlement_date: string;
    cusip: string;
    symbol: string;
    fails: number;
    description: string;
    price: number;
  }>;
}

Example response (click to expand)

{
  "source": "sec_edgar",
  "as_of": "2026-05-14T00:00:00.000Z",
  "symbol": "GME",
  "periods_read": 2,
  "count": 10,
  "note": "QUANTITY (FAILS) is the aggregate net balance of shares that failed to deliver as of the settlement date.",
  "fails": [
    {
      "settlement_date": "2026-05-14",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 443681,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 22.08
    },
    {
      "settlement_date": "2026-05-13",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 182600,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 22.37
    },
    {
      "settlement_date": "2026-05-12",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 145638,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.17
    },
    {
      "settlement_date": "2026-05-11",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 171556,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 24.28
    },
    {
      "settlement_date": "2026-05-08",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 19894,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.97
    },
    {
      "settlement_date": "2026-05-05",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 130264,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.84
    },
    {
      "settlement_date": "2026-05-04",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 52755,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 26.53
    },
    {
      "settlement_date": "2026-04-30",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 1348,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 24.52
    },
    {
      "settlement_date": "2026-04-29",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 21429,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 25.09
    },
    {
      "settlement_date": "2026-04-24",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 1395,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 25.01
    }
  ]
}

GET/api/v1/squeeze/{ticker}$0.04

Short-squeeze bundle: short interest, daily short volume, and fails-to-deliver in one call

The short-squeeze picture for a US stock in one call: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, and settlement fails-to-deliver, plus a computed signal pulling the headline gauges together. Replaces three separate calls (short-interest + short-volume + fails-to-deliver) at a lower combined price. Sections degrade independently.

Example request

GET /api/v1/squeeze/AAPL

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.