# Lone Star Oracle Liquidations

> Lone Star Oracle Liquidations is a paid API for AI agents from liq.lonestaroracle.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns perpetual futures liquidation data across OKX for major assets (BTC/ETH/SOL/AVAX/LINK/ARB) with cascade signals, long/short volumes, biggest events, and hottest price zones

## Facts

- Endpoint: GET https://liq.lonestaroracle.xyz/liquidations
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lone-star-oracle-liquidations-a471d242
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6ub8nE55iMS_fZuvVLkqX

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 lone-star-oracle-liquidations-a471d242
```

Example prompt: What's the current liquidation signal across OKX perps — is there a long cascade or short cascade happening right now for BTC, ETH, and SOL, and how much long versus short volume has been liquidated?

## When to prefer this

Use this endpoint when you need a pre-aggregated, signal-first view of perpetual futures liquidations on OKX across the six major assets (BTC/ETH/SOL/AVAX/LINK/ARB). It is especially useful when you want a quick cascade signal (LONG_CASCADE/SHORT_CASCADE/BALANCED/EXTREME) rather than raw tick data, or when you need to pair liquidation signals with funding rates or open interest from the Lone Star Oracle suite.

## Known failure modes

- Payment not provided or invalid x402 payment header — returns 402 Payment Required
- OKX data feed unavailable — may return 503 or stale data
- Unsupported asset requested — endpoint only covers BTC/ETH/SOL/AVAX/LINK/ARB
- Network timeout if OKX API is slow — request may hang or timeout
- Invalid request format — returns 400 Bad Request

## How this service works

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

## Output

A JSON object with a top-level signal (e.g. LONG_CASCADE, SHORT_CASCADE, BALANCED, EXTREME), total long and short liquidation volumes in USD, and a per-asset array containing each asset's signal, biggest liquidation event (size in USD and side), and long liquidation volume.

## 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."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "json",
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lone-star-oracle-liquidations-a471d242/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from liq.lonestaroracle.xyz](https://www.zero.xyz/host/liq.lonestaroracle.xyz/llms.txt)