Skip to main content
GET
/
api
/
v1
/
liquidations
/
fusion
KROVN Fusion Score
curl --request GET \
  --url https://api.example.com/api/v1/liquidations/fusion
Combines four independent liquidation models into a single unified heatmap using Thompson Sampling for adaptive model weighting. The four models are: Predicted Zones (OI-based), Cascade Simulation, Regime-Adjusted, and OI Velocity. This is a KROVN-exclusive feature.

​
Parameters

ParameterTypeDefaultDescription
symbolstringBTCUSDTTrading pair

​
Example Request

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

​
Example Response

{
  "symbol": "BTCUSDT",
  "currentPrice": 87420.50,
  "buckets": [
    {
      "price": 85100.00,
      "fusionScore": 82,
      "predicted": 72,
      "cascade": 65,
      "regime": 88,
      "velocity": 45
    },
    {
      "price": 86200.00,
      "fusionScore": 51,
      "predicted": 45,
      "cascade": 38,
      "regime": 62,
      "velocity": 30
    },
    {
      "price": 88800.00,
      "fusionScore": 67,
      "predicted": 58,
      "cascade": 55,
      "regime": 71,
      "velocity": 52
    }
  ],
  "modelWeights": {
    "predicted": 0.35,
    "cascade": 0.25,
    "regime": 0.22,
    "velocity": 0.18,
    "source": "thompson_sampling"
  },
  "meta": {
    "modelsUsed": 4,
    "weightSource": "thompson_sampling"
  },
  "computedAt": "2026-03-21T12:30:00.000Z"
}
The fusionScore (0-100) is the weighted combination of all model scores at each price level. Model weights are adaptive — Thompson Sampling continuously updates them based on prediction accuracy. Higher fusion scores indicate stronger liquidation risk at that price level.