# LoneStarOracle Liquidations

> LoneStarOracle Liquidations is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns a full liquidation report for major crypto perps (BTC/ETH/SOL/AVAX/LINK/ARB) including long/short cascade signals, volume breakdown, biggest single events, and hottest price zones

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_liq_lonestaroracle_xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestaroracle-liquidations-8c2e6a88
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4V5q32kUd5H5HDmdv2_ps

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 lonestaroracle-liquidations-8c2e6a88
```

Example prompt: What's the current liquidation signal for crypto perps — is there a long or short cascade forming across BTC, ETH, and SOL right now, and where are the hottest price zones?

## When to prefer this

Choose this endpoint when you need a quick, signal-first liquidation overview across major crypto perp markets (BTC, ETH, SOL, AVAX, LINK, ARB) with clear cascade classification and hot zone data. Ideal for pre-trade risk checks, real-time monitoring dashboards, or any agent workflow that needs to detect liquidation cascade risk without building its own aggregation logic. The 5-minute cache makes it suitable for near-real-time use cases rather than tick-by-tick latency requirements.

## Known failure modes

- Payment not included or invalid x402 payment header — returns 402 Payment Required
- Network or upstream data source unavailable — may return 5xx error
- Stale data if cache is within 5-minute window — data may be up to 5 minutes old
- Unsupported HTTP method used — only GET/HEAD/DELETE accepted

## How this service works

Full liquidation report — all assets, long/short breakdown, hot zones

## Output

Returns a JSON object with a top-level market signal (LONG_CASCADE, SHORT_CASCADE, BALANCED, or EXTREME), total long and short USD liquidation volumes, and a per-asset breakdown including each asset's signal, long/short USD volumes, and the biggest single liquidation event (size in USD and side). Data is cached at a 5-minute interval.

## Request schema (JSON Schema)

```json
{
 "name": "LoneStarOracle — Liquidations",
 "tags": [
  "liquidations",
  "perps",
  "futures",
  "cascade",
  "crypto",
  "trading",
  "risk"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "crypto",
 "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": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "assets": [
      {
       "asset": "BTC",
       "signal": "LONG_CASCADE",
       "biggest": {
        "usd": 4200000,
        "side": "long"
       },
       "long_usd": 30000000
      }
     ],
     "signal": "LONG_CASCADE",
     "total_long_usd": 45000000,
     "total_short_usd": 8000000
    }
   }
  }
 },
 "description": "Perp liquidation data for BTC/ETH/SOL/AVAX/LINK/ARB. Signal-first: LONG_CASCADE/SHORT_CASCADE/BALANCED/EXTREME. Long vs short volume, biggest single events, hottest price zones. 5-min cache."
}
```

## More

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