# x402stock Short-Squeeze Composite for US Stocks

> x402stock Short-Squeeze Composite for US Stocks is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.04/call, status unknown (last checked 2026-09-12).

Returns a combined short-squeeze picture for a US stock: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, settlement fails-to-deliver, and a computed composite signal.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/squeeze/{ticker}
- Price: $0.04/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-short-squeeze-composite-for-us-stocks-508bbaa4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7zVyWgN8skSE-XaN4IEpQ

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 agents-x402stock-xyz-x402stock-short-squeeze-composite-for-us-stocks-508bbaa4
```

Example prompt: Pull the full short-squeeze picture for GME — short interest with days-to-cover, daily short-volume ratio, fails-to-deliver, and the composite signal — all in one shot.

## When to prefer this

Use this endpoint when you need a complete short-squeeze picture for a US stock in a single call and want to avoid paying for three separate endpoints (short-interest, short-volume, fails-to-deliver). It is cheaper combined and gives a pre-computed composite signal, making it ideal for screening, alerting, or research workflows where all three dimensions of short pressure matter.

## Known failure modes

- Unknown or delisted ticker returns empty or null sections
- FINRA/SEC data may lag by several days, so 'as_of' may not be today
- Individual sections (short_interest, short_volume, fails_to_deliver) can be null if source data is unavailable, while others succeed
- Non-US or OTC-only tickers may return partial or empty data
- Payment failure (402) if USDC balance is insufficient

## How this service works

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. From x402stock

## Output

A JSON object containing: the ticker and data timestamp; a 'sections' map indicating status of each sub-dataset; a 'signal' object with headline composite gauges (days_to_cover, short_interest, short_volume_ratio); full short_interest history with days-to-cover per period; full short_volume history with per-venue breakdown and short_volume_ratio per day; and fails_to_deliver aggregate data. Sections degrade independently if a sub-source is unavailable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "source",
  "as_of",
  "sections",
  "signal",
  "short_interest",
  "short_volume",
  "fails_to_deliver"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "signal": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "days_to_cover",
      "short_interest",
      "short_volume_ratio"
     ],
     "properties": {
      "days_to_cover": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "short_interest": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "short_volume_ratio": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "ticker": {
   "type": "string"
  },
  "sections": {
   "type": "object",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {
    "type": "string"
   }
  },
  "short_volume": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "count",
        "latest",
        "history"
       ],
       "properties": {
        "count": {
         "type": "number"
        },
        "latest": {
         "anyOf": [
          {
           "type": "object",
           "required": [
            "date",
            "total_volume",
            "short_volume",
            "exempt_volume",
            "non_exempt_volume",
            "short_volume_ratio",
            "venues"
           ],
           "properties": {
            "date": {
             "type": "string"
            },
            "venues": {
             "type": "object",
             "required": [
              "nyse",
              "nasdaq_carteret",
              "nasdaq_chicago",
              "adf"
             ],
             "properties": {
              "adf": {
               "anyOf": [
                {
                 "type": "number"
                },
                {
                 "type": "null"
                }
               ]
              },
              "nyse": {
               "anyOf": [
                
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-short-squeeze-composite-for-us-stocks-508bbaa4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)