清算接口

已发生清算

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

返回已经发生的多头、空头清算，按时间从新到旧排列。

参数	必填	可选值	默认值
asset	是	BTC、ETH	—
interval	否	1h、1d	1h
limit	否	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 使用 UTC。金额字段均为以 USD 计价的十进制字符串。

潜在清算密集区

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

返回根据公开可见仓位样本估算的最新快照，不接受查询参数。

{
  "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 是价格桶距快照标记价格的绝对距离。long 价格桶位于标记价格下方， short 价格桶位于标记价格上方。尚无快照时，snapshot 为 null。

样本估算，不是全市场清算地图

响应覆盖本次扫描范围内清算价格有效的仓位；账户资产和单仓金额固定门槛已关闭， coverage 中对应的零值用于说明该行为。结果不是完整的清算挂单簿，也不能保证一定在该 价格发生清算。仓位调整、追加保证金和市场价格变化都会改变结果。引用结论时必须同时说明 coverage 样本范围。