# SqueezeSignal

> SqueezeSignal is a paid API for AI agents from squeeze.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a short-squeeze risk signal (HIGH/ELEVATED/MODERATE/LOW), squeeze state, score, and key drivers for a given stock ticker

## Facts

- Endpoint: GET https://squeeze.lonestaroracle.xyz/squeeze
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/squeezesignal-8b64ab98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y2UeQzIN4C1uuHlWdP2Oa

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 squeezesignal-8b64ab98
```

Example prompt: What's the short-squeeze risk signal for GameStop (GME) right now — is it coiled, igniting, or quiet, and what are the main drivers like short interest and days-to-cover?

## When to prefer this

Choose this endpoint when an agent needs a fast, structured squeeze-risk verdict for a single equity ticker, especially for meme stocks or names with known heavy short interest. It is ideal for pre-trade screening, risk flagging for existing short positions, or surfacing squeeze setups in a watchlist workflow. Prefer it over general financial data APIs when the specific output needed is squeeze state classification plus driver explanation, rather than raw price or fundamental data.

## Known failure modes

- Invalid or unknown ticker returns an error or empty result
- Data may be stale — short interest is bi-monthly and approximately 2 weeks lagged
- Tickers not covered by FINRA/yfinance (e.g. OTC pink sheets) may return incomplete data
- Payment failure via x402 if insufficient USDC balance on Base
- Rate limiting or upstream yfinance downtime causing failed data fetch

## How this service works

Short-squeeze setup signal for a stock (?ticker=<stock ticker>)

## Output

Returns a JSON object with: squeeze_signal (HIGH/ELEVATED/MODERATE/LOW), squeeze_score (0–10), squeeze_state (coiled/igniting/primed/quiet), company name, ticker, key driver strings explaining the conditions, and underlying metrics including short_pct_float, days_to_cover, price, vs_50d_avg_pct, shares_short, and short_interest_trend. Also includes the data source (yfinance/FINRA) and an interpretation sentence.

## Request schema (JSON Schema)

```json
{
 "name": "SqueezeSignal",
 "tags": [
  "short-squeeze",
  "short-interest",
  "equities",
  "trading",
  "risk"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "markets",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "ticker": {
       "type": "string",
       "example": "GME",
       "description": "Stock ticker to screen for squeeze risk (e.g. GME, BYND, CVNA). Aliases: symbol."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "state": "coiled",
     "source": "yfinance (FINRA short interest + price)",
     "ticker": "GME",
     "company": "GameStop Corporation",
     "drivers": [
      "short interest 13.5% of float (high)",
      "days-to-cover 12.8 (crowded, slow to exit)"
     ],
     "metrics": {
      "price": 19.1,
      "shares_short": 55426276,
      "days_to_cover": 12.78,
      "fifty_day_avg": 21.78,
      "vs_50d_avg_pct": -12.4,
      "short_pct_float": 13.54,
      "short_interest_trend": "flat"
     },
     "max_score": 10,
     "squeeze_score": 5,
     "interpretation": "Notable short-squeeze conditions — heavily shorted but still falling; fuel is building, not yet lit.",
     "squeeze_signal": "ELEVATED"
    }
   }
  }
 },
 "description": "Short-squeeze detection made agent-callable. One x402 call takes a stock ticker and returns a squeeze-risk signal (HIGH / ELEVATED / MODERATE / LOW) built from short interest as a percent of float and days-to-cover, plus a state read (coiled = heavily shorted but still falling / igniting = heavily shorted AND rising / primed / quiet) that blends price momentum vs the 50-day average with the short-interest trend. Names the drivers (e.g. 'short interest 25.7% of float', 'days-to-cover 12.8', 'price 9% above its 50-day avg'). What a trading or risk agent needs to flag squeeze setups, pay-per-call. $0.05 in USDC on Base via x402. Source: yfinance (FINRA short interest + price; free/public). NOTE: short interest is bi-monthly and ~2 weeks lagged, and this does NOT include real-time borrow fee / share utilization (paid data
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/squeezesignal-8b64ab98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from squeeze.lonestaroracle.xyz](https://www.zero.xyz/host/squeeze.lonestaroracle.xyz/llms.txt)