Liquidation Bubbles

Pro

GET /liquidations/bubbles

Anomaly detection for liquidation activity. Compares each symbol×exchange pair's recent liquidation USD against a baseline period and surfaces entries with the highest anomaly ratio — the biggest spikes relative to what's normal for that pair. Use it to find where forced selling is unusually concentrated before it shows up in price.

Authentication

Requires Pro tier or higher. Free and Dev tiers do not have access (returns 403).

Parameters

Query parameters

Name	Type	Required	Description
`range`	string	–	7d, 30d, or 90d. Defaults to 7d.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/liquidations/bubbles?range=7d"

Example response

json

{
  "data": [
    {
      "symbol": "BTC",
      "exchanges": {
        "binance": {
          "recent_long_usd": 320000000,
          "recent_short_usd": 140000000,
          "baseline_long_usd": 95000000,
          "baseline_short_usd": 42000000
        }
      },
      "anomaly_ratio": 3.37
    },
    {
      "symbol": "ETH",
      "exchanges": {
        "bybit": {
          "recent_long_usd": 87000000,
          "recent_short_usd": 38000000,
          "baseline_long_usd": 42000000,
          "baseline_short_usd": 18000000
        }
      },
      "anomaly_ratio": 2.07
    }
  ]
}

Errors

403 — Your tier does not have access. Upgrade to Pro.

For authentication errors (401) and rate limit responses (429), see Errors.