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

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.

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

Path parameters

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

Asset slug (lowercase). All 17 assets supported.

Response

Liquidation cluster map returned (payment verified)

availableboolean required

assetstring required

as_ofstring date-time required

mark_pricenumber nullable

open_interestnumber nullable

funding_ratenumber nullable

disclaimerstring required

Example response

{
  "available": true,
  "asset": "BTC-USD",
  "mark_price": 107500,
  "open_interest": 84320.15,
  "funding_rate": 0.0001,
  "cluster_map": {
    "long_clusters": [
      {
        "leverage": 50,
        "liq_price": 106425,
        "distance_pct": -0.98,
        "estimated_oi_fraction": 0.051
      }
    ],
    "short_clusters": [
      {
        "leverage": 50,
        "liq_price": 108575,
        "distance_pct": 1,
        "estimated_oi_fraction": 0.049
      }
    ]
  },
  "recent_prints": {
    "source": "okx-public"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.