Liquidation endpoints

Realized liquidations

GET /api/wgo/v1/derivatives/{asset}/liquidations

Returns already-realized long and short liquidations, newest bucket first.

Parameter	Required	Values	Default
asset	yes	BTC, ETH	—
interval	no	1h, 1d	1h
limit	no	1–2000	168

curl -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/wgo/v1/derivatives/BTC/liquidations?interval=1h&limit=24"

{
  "asset": "BTC",
  "interval": "1h",
  "count": 1,
  "data": [
    {
      "asset": "BTC",
      "interval": "1h",
      "bucket_start": "2026-08-23T16:00:00+00:00",
      "long_liquidation_usd": "120000.25",
      "short_liquidation_usd": "80000.50",
      "total_liquidation_usd": "200000.75"
    }
  ]
}

bucket_start is UTC. Amount fields are decimal strings denominated in USD.

Potential liquidation zones

GET /api/wgo/v1/derivatives/{asset}/liquidation-map

Returns the latest estimate derived from a sampled set of publicly visible positions. It takes no query parameters.

{
  "asset": "BTC",
  "snapshot": {
    "asset": "BTC",
    "snapshot_at": "2026-08-23T16:00:00+00:00",
    "mark_price": "117000",
    "open_interest_native": "12345.67",
    "coverage": {
      "account_value_threshold_usd": "0",
      "position_notional_threshold_usd": "0",
      "bucket_width_bps": 25,
      "max_distance_bps": 5000,
      "leaderboard_accounts": 43525,
      "selected_accounts": 2500,
      "scanned_accounts": 2489,
      "failed_accounts": 11,
      "positions_seen": 742,
      "positions_included": 86
    },
    "long_notional_usd": "154665100",
    "short_notional_usd": "73527648",
    "buckets": [
      {
        "side": "long",
        "price_low": "108225",
        "price_high": "108517.5",
        "liquidation_notional_usd": "42000000",
        "position_count": 3,
        "distance_bps": "737.18"
      }
    ]
  }
}

distance_bps is the absolute distance from the snapshot mark price. A long bucket is below the mark price and a short bucket is above it. When no snapshot exists, snapshot is null.

Sample estimate, not a full-market map

The response covers valid positions found in the current scan population. Fixed account-value and per-position notional filters are disabled; the zero values in coverage document that behavior. It is not a complete liquidation order book or a guaranteed liquidation price. Position changes, added collateral, and market moves can change the result. Always report the coverage object together with any conclusion.