# Kronos Liquidation Cluster Map API

> Kronos Liquidation Cluster Map API is a paid API for AI agents from kronossignals.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns estimated liquidation cluster map, open interest, funding rate, and recent liquidation prints for a specified crypto asset

## Facts

- Endpoint: GET https://kronossignals.com/api/v1/liquidations/%7Basset%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kronos-liquidation-cluster-map-api-5ad404ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OXB83OxkgrN7oRT7xQOg3

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 kronos-liquidation-cluster-map-api-5ad404ec
```

Example prompt: Pull the current liquidation cluster map for BTC-USD — I want to see where the nearest long and short liquidation clusters are, the squeeze bias, open interest, and any recent liquidation prints.

## When to prefer this

Choose this endpoint when you need a structured, model-estimated view of where leveraged positions are likely to liquidate across multiple leverage bands for a specific crypto asset, along with real funding rate, OI, and recent liquidation print data. It is particularly useful for pre-trade risk analysis, squeeze detection, and derivatives market briefings. Prefer this over generic price feeds when the specific question involves leveraged position risk, cascade liquidation zones, or open interest distribution.

## Known failure modes

- Unsupported asset symbol returns an error or available:false response
- Stale data if the underlying OKX feed or OI source is delayed
- Model estimates may diverge significantly from actual liquidation orders since they are derived from OI distribution assumptions, not real order book data
- Payment failure via x402 if USDC balance is insufficient or the x402 facilitator is unreachable
- Rate limiting if many requests are made in quick succession without sufficient payment flow

## How this service works

Paid market-intelligence API over x402

## Output

Returns a JSON object with: current mark price, funding rate, total open interest, a cluster_map with estimated long and short liquidation price levels grouped by leverage band (5x/10x/25x/50x) with distance percentages and OI fractions, a squeeze_bias indicator, nearest long and short liquidation cluster summaries, and recent liquidation prints (side, size, price, time) sourced from OKX public data. Includes disclaimers that cluster estimates are modeled from OI and leverage-band distributions, not a live order book.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-07-02T10:00:00.000Z",
  "asset": "BTC-USD",
  "available": true,
  "disclaimer": "Cluster map is estimated from OI and leverage-band modeling — NOT a live order book. Not financial advice.",
  "mark_price": 107500,
  "cluster_map": {
   "disclaimer": "ESTIMATED clusters from OI + leverage-band modeling. NOT confirmed orders.",
   "model_note": "OI distributed: 5x=35%, 10x=30%, 25x=25%, 50x=10%. Long/short split adjusted by funding rate.",
   "squeeze_bias": "long_squeeze_risk",
   "long_clusters": [
    {
     "leverage": 50,
     "liq_price": 106425,
     "distance_pct": -0.98,
     "estimated_oi_fraction": 0.051
    },
    {
     "leverage": 25,
     "liq_price": 103375,
     "distance_pct": -3.84,
     "estimated_oi_fraction": 0.1275
    }
   ],
   "short_clusters": [
    {
     "leverage": 50,
     "liq_price": 108575,
     "distance_pct": 1,
     "estimated_oi_fraction": 0.049
    },
    {
     "leverage": 25,
     "liq_price": 111625,
     "distance_pct": 3.84,
     "estimated_oi_fraction": 0.1225
    }
   ],
   "total_long_oi_estimate": 44571,
   "total_short_oi_estimate": 39749.15,
   "nearest_long_liq_cluster": {
    "liq_price": 106425,
    "distance_pct": -0.98
   },
   "nearest_short_liq_cluster": {
    "liq_price": 108575,
    "distance_pct": 1
   }
  },
  "funding_rate": 0.0001,
  "open_interest": 84320.15,
  "recent_prints": {
   "note": "side:buy = short position liquidated (forced buy to close); side:sell = long position liquidated (forced sell to close).",
   "count": 5,
   "prints": [
    {
     "side": "buy",
     "size": 10.1,
     "time": "2026-07-02T09:45:00.000Z",
     "price": 107600.5,
     "pos_side": "short"
    }
   ],
   "source": "okx-public",
   "available": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kronos-liquidation-cluster-map-api-5ad404ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kronossignals.com](https://www.zero.xyz/host/kronossignals.com/llms.txt)