---
title: WGO 清算接口
description: BTC、ETH 已发生清算历史与潜在清算密集区样本估算。
---

# 清算接口

## 已发生清算

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

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

| 参数 | 必填 | 可选值 | 默认值 |
| --- | --- | --- | --- |
| `asset` | 是 | `BTC`、`ETH` | — |
| `interval` | 否 | `1h`、`1d` | `1h` |
| `limit` | 否 | `1`–`2000` | `168` |

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

```json
{
  "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 计价的十进制字符串。

## 潜在清算密集区

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

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

```json
{
  "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`。

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