Skip to main content
GET
/
api
/
v1
/
liquidations
/
cascade
Cascade Simulation
curl --request GET \
  --url https://api.example.com/api/v1/liquidations/cascade
Simulates what happens when price hits a liquidation cluster and triggers a chain reaction. Each liquidation pushes price further, triggering the next cluster — a cascade. Returns the projected cascade floor (max downside) and cascade ceiling (max upside). This is a KROVN-exclusive feature — no competitor offers cascade simulation.

​
Parameters

ParameterTypeDefaultDescription
symbolstringBTCUSDTTrading pair

​
Example Request

curl -X GET "https://krovn.io/api/v1/liquidations/cascade?symbol=BTCUSDT" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "symbol": "BTCUSDT",
  "currentPrice": 87420.50,
  "downPath": [
    {
      "price": 85100.00,
      "intensity": 72,
      "impactPct": 0.54,
      "priceAfter": 86948.22
    },
    {
      "price": 83500.00,
      "intensity": 48,
      "impactPct": 0.36,
      "priceAfter": 86635.01
    },
    {
      "price": 81200.00,
      "intensity": 35,
      "impactPct": 0.26,
      "priceAfter": 86409.68
    }
  ],
  "cascadeFloor": 86409.68,
  "cascadeFloorPct": -1.16,
  "upPath": [
    {
      "price": 88800.00,
      "intensity": 58,
      "impactPct": 0.44,
      "priceAfter": 87805.14
    },
    {
      "price": 90500.00,
      "intensity": 41,
      "impactPct": 0.31,
      "priceAfter": 88077.34
    }
  ],
  "cascadeCeiling": 88077.34,
  "cascadeCeilingPct": 0.75,
  "avgHourlyVolume": 42500000,
  "computedAt": "2026-03-21T12:30:00.000Z"
}
The downPath simulates cascading long liquidations (price falls). The upPath simulates cascading short squeezes (price rises). Each step shows the liquidation cluster price, its intensity, the percentage impact on price, and the resulting price after that cascade step.