# x402stock Short Squeeze Score API

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

Returns a weighted 5-factor short-squeeze pressure score (0-100) for a given US stock ticker, including sub-scores for short interest, days to cover, short volume ratio, fails-to-deliver, and price/social momentum.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/score/squeeze/%7Bticker%7D
- Price: $0.15/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-score-api-49e9553d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bTKFCCplhuWtzlJThnzyt

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-score-api-49e9553d
```

Example prompt: What's the current short squeeze score for GME — give me the full breakdown including days to cover, short interest percentage, and the rationale?

## When to prefer this

Use this endpoint when you need a structured, quantitative squeeze-pressure gauge for a specific US equity, especially for high-short-interest or meme stocks. Prefer this over generic quote APIs when the user's question is specifically about short-squeeze risk, short interest levels, days-to-cover, or retail squeeze momentum rather than price, fundamentals, or earnings.

## Known failure modes

- Unknown or invalid ticker returns an error or empty result
- Ticker exists but insufficient data for one or more factors reduces confidence score
- Stale data if short interest reporting lags (periodic, not real-time)
- Non-US or OTC tickers may not be supported
- Payment failure via x402/USDC blocks the request

## 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 with a composite squeeze score (0-100) with a label (e.g. 'elevated'), five sub-factor scores (short interest %, days to cover, short volume ratio, fails-to-deliver, price/social spark), a plain-English rationale, confidence level, methodology explanation, and a disclaimer. Includes the raw input values used and a data-freshness timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-08T12:00:00.000Z",
  "score": {
   "max": 100,
   "label": "elevated",
   "value": 68,
   "factors": [
    {
     "max": 30,
     "name": "short_interest_pct",
     "unit": "%",
     "label": "Short interest vs shares outstanding",
     "score": 18,
     "value": 12.4
    },
    {
     "max": 25,
     "name": "days_to_cover",
     "unit": "days",
     "label": "Days to cover",
     "score": 15,
     "value": 5.2
    },
    {
     "max": 20,
     "name": "short_volume_ratio",
     "unit": "%",
     "label": "Daily short-volume ratio",
     "score": 11,
     "value": 46.1
    },
    {
     "max": 15,
     "name": "fails_to_deliver",
     "unit": "%",
     "label": "Fails-to-deliver vs ADV",
     "score": 6,
     "value": 0.9
    },
    {
     "max": 10,
     "name": "spark",
     "unit": "%chg",
     "label": "Price momentum + social attention",
     "score": 8,
     "value": 4.3
    }
   ],
   "confidence": 1
  },
  "inputs": {
   "short_interest": 22500000,
   "day_change_percent": 4.3,
   "shares_outstanding": 181000000,
   "short_volume_ratio": 46.1,
   "days_to_cover_rising": true
  },
  "source": "x402stock",
  "ticker": "GME",
  "sections": {
   "short_volume": "ok",
   "short_interest": "ok",
   "fails_to_deliver": "ok"
  },
  "rationale": "GME scores 68/100 (elevated) for short-squeeze pressure. Biggest contributor: days to cover (15/25). Days to cover 5.2 and rising. Short interest ≈ 12.4% of shares. Currently trending on retail forums.",
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting.",
  "methodology": "Weighted 5-factor gauge: short interest %-of-shares (30) + days-to-cover (25) + daily short-volume ratio (20) + fails-to-deliver vs ADV (15) + price/social spark (10). Higher = more squeeze pressure."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-short-squeeze-score-api-49e9553d/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)