# x402stock Short Squeeze Data API

> x402stock Short Squeeze Data API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Returns short squeeze indicators for a US stock ticker, including short interest, short volume ratio, days-to-cover, and fails-to-deliver data.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/squeeze/%7Bticker%7D
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-short-squeeze-data-api-188b2543
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2xGAuQMxxp9lzcCH9Kg77

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-short-squeeze-data-api-188b2543
```

Example prompt: What's the short squeeze situation for GME right now — give me the days-to-cover, short interest, short volume ratio, and any fails-to-deliver.

## When to prefer this

Use this endpoint when you need consolidated short squeeze metrics for a US-listed stock in a single call — especially when you need days-to-cover, short volume ratio, short interest, and fails-to-deliver together without managing API keys or subscriptions. Prefer this over generic financial data APIs when the focus is specifically on short selling pressure and squeeze potential.

## Known failure modes

- Ticker not found or unsupported — returns error for non-US or delisted tickers
- Payment not received — 402 response if USDC payment via x402 on Base is not attached
- Short interest data unavailable for OTC or thinly traded stocks
- Fails-to-deliver data may lag by weeks due to SEC EDGAR reporting schedule
- Short volume data only available for recent trading sessions

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: a signal summary (days-to-cover, short interest, short volume ratio), short volume data broken down by venue (NYSE, NASDAQ, ADF) for recent dates, historical short interest with settlement dates and average daily volume, and fails-to-deliver data sourced from SEC EDGAR — all timestamped and tagged with the requested ticker.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-04T12:00:00.000Z",
  "signal": {
   "days_to_cover": 2.39,
   "short_interest": 124500000,
   "short_volume_ratio": 38.76
  },
  "source": "x402stock",
  "ticker": "GME",
  "sections": {
   "short_volume": "ok",
   "short_interest": "ok",
   "fails_to_deliver": "ok"
  },
  "short_volume": {
   "data": {
    "count": 1,
    "latest": {
     "date": "2026-05-29",
     "venues": {
      "adf": 0,
      "nyse": 665260,
      "nasdaq_chicago": 48267,
      "nasdaq_carteret": 6563392
     },
     "short_volume": 7276919,
     "total_volume": 18774437,
     "exempt_volume": 106446,
     "non_exempt_volume": 7170473,
     "short_volume_ratio": 38.76
    },
    "history": [
     {
      "date": "2026-05-29",
      "venues": {
       "adf": 0,
       "nyse": 665260,
       "nasdaq_chicago": 48267,
       "nasdaq_carteret": 6563392
      },
      "short_volume": 7276919,
      "total_volume": 18774437,
      "exempt_volume": 106446,
      "non_exempt_volume": 7170473,
      "short_volume_ratio": 38.76
     }
    ]
   },
   "as_of": "2026-05-29T00:00:00.000Z",
   "source": "x402stock",
   "ticker": "AAPL"
  },
  "short_interest": {
   "data": {
    "count": 1,
    "latest": {
     "days_to_cover": 2.39,
     "short_interest": 124500000,
     "settlement_date": "2026-05-15",
     "avg_daily_volume": 52000000
    },
    "history": [
     {
      "days_to_cover": 2.39,
      "short_interest": 124500000,
      "settlement_date": "2026-05-15",
      "avg_daily_volume": 52000000
     }
    ]
   },
   "as_of": "2026-05-15T00:00:00.000Z",
   "source": "x402stock",
   "ticker": "AAPL"
  },
  "fails_to_deliver": {
   "note": "QUANTITY (FAILS) is the aggregate net balance of shares that failed to deliver as of the settlement date.",
   "as_of": "2026-04-30T00:00:00.000Z",
   "count": 1,
   "fails": [
    {
     "cusip": "36467W109",
     "fails": 124500,
     "price": 24.13,
     "symbol": "GME",
     "description": "GAMESTOP CORP",
     "settlement_date": "2026-04-30"
    }
   ],
   "source": "sec_edgar",
   "symbol": "GME",
   "periods_read": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-short-squeeze-data-api-188b2543/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)