---
title: "Forward liquidation cluster map + recent prints (17 assets) — $0.02/call"
method: GET
path: "/api/v1/liquidations/{asset}"
tags: ["liquidations", "derivatives", "paid"]
---

# Forward liquidation cluster map + recent prints (17 assets) — $0.02/call

`GET /api/v1/liquidations/{asset}`

## Request

- Base URL: `https://kronossignals.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kronossignals.com/api/v1/liquidations/{asset}`
- Auth: none declared

Returns a forward liquidation cluster map and recent liquidation prints for any of the 16 supported assets. Part A (always): estimated liq price levels for 5x/10x/25x/50x leverage bands, modeled from open interest and mark price — no new upstream source (reuses OKX data from the 5-min cron). Includes nearest_long/short liq clusters, squeeze_bias (long_squeeze_risk / short_squeeze_risk / balanced), and explicit disclaimer that these are model estimates, not real order book data. Part B (best-effort): recent liquidation prints from OKX public API (no auth). If OKX is unreachable: recent_prints.available=false — never fabricated. Supports BTC/ETH/SOL/BNB/XRP/DOGE/ADA/AVAX/LINK/DOT/LTC/TRX/BCH/ATOM/NEAR/APT. Costs $0.02 USDC on Base mainnet via x402.

## Path parameters

- `asset` 'btc' | 'eth' | 'sol' | 'bnb' | 'xrp' | 'doge' | 'ada' | 'avax' | 'link' | 'dot' | 'ltc' | 'trx' | 'bch' | 'atom' | 'near' | 'apt', required

## Response `200`

Liquidation cluster map returned (payment verified)

- object
  - `available` boolean, required
  - `asset` string, required
  - `as_of` string, date-time, required
  - `mark_price` number, nullable
  - `open_interest` number, nullable
  - `funding_rate` number, nullable
  - `cluster_map` object, required: Forward liquidation cluster map. Estimated, not from order book. See disclaimer and model_note fields.
    - `disclaimer` string
    - `model_note` string
    - `long_clusters` object[]: Estimated long liq levels below mark price, nearest first.
      - `leverage` integer
      - `liq_price` number
      - `distance_pct` number
      - `estimated_oi_fraction` number
    - `short_clusters` object[]: Estimated short liq levels above mark price, nearest first.
      - `leverage` integer
      - `liq_price` number
      - `distance_pct` number
      - `estimated_oi_fraction` number
    - `nearest_long_liq_cluster` object, nullable
      - `liq_price` number
      - `distance_pct` number
    - `nearest_short_liq_cluster` object, nullable
      - `liq_price` number
      - `distance_pct` number
    - `squeeze_bias` 'long_squeeze_risk' | 'short_squeeze_risk' | 'balanced': long_squeeze_risk = more long OI at risk (cascade if price drops); short_squeeze_risk = more short OI at risk (cascade if price rises).
    - `total_long_oi_estimate` number
    - `total_short_oi_estimate` number
  - `recent_prints` object, required: Recent liquidation prints from OKX public API. Never fabricated.
    - `available` boolean
    - `source` string, nullable
    - `count` integer, nullable
    - `prints` object[], nullable
      - `side` 'buy' | 'sell'
      - `pos_side` 'long' | 'short'
      - `size` number
      - `price` number
      - `time` string, date-time
    - `note` string, nullable
    - `reason` string, nullable
  - `disclaimer` string, required

## Other responses

- `400`: Unsupported asset slug.
- `402`: Payment Required — x402 micropayment instructions in response body
- `503`: Derivatives data unavailable (market_signals not populated).

---

[API](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api.md) · [All operations](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/revisions/bfdcf7230e93?raw)