清算历史

返回调用者在 unified 模式下发生的强平事件，最新的排在最前。

每一条记录对应清算瀑布中的一次平仓（uniMMR ≤ 1.05 时每 2 秒一个 tick，每 tick 平一个亏损最大的仓位）。若该次清算触发了 ADL 以覆盖保险基金缺口， liquidation_type == "adl"。

HTTP 请求

GET /api/v1/unified/liquidations (HMAC SHA256)

请求参数

名称	类型	是否必需	默认值	描述
limit	INT	NO	20	每页条数，`1 ≤ limit ≤ 200`
offset	INT	NO	0	分页偏移
timestamp	LONG	YES	—	时间戳

响应示例

{
    "liquidations": [
        {
            "id": "e8d3ff4c-2a19-4b77-a5c5-8e2c6cc23e14",
            "position_id": "91e9a82c-5df1-4f72-9e01-7f56f1d7df02",
            "symbol": "BTCUSDT",
            "side": "long",
            "closed_size_usd": "50000.000000000000000000",
            "closed_size_tokens": "0.500000000000000000",
            "mark_price": "98500.000000000000000000",
            "pnl_realized": "-1500.000000000000000000",
            "collateral_returned": "350.000000000000000000",
            "trigger_uni_mmr": "1.031000000000000000",
            "trigger_equity": "120.500000000000000000",
            "post_uni_mmr": null,
            "liquidation_type": "full",
            "created_at": "2026-04-13T05:12:34.567890Z"
        }
    ],
    "total": 1
}

字段说明

字段	含义
`position_id`	被平仓位的 UUID
`closed_size_usd` / `closed_size_tokens`	按 mark price 平掉的仓位尺寸
`mark_price`	平仓使用的价格
`pnl_realized`	平掉部分的已实现盈亏
`collateral_returned`	扣除手续费 / 保险分摊后退回 `available_balance` 的保证金
`trigger_uni_mmr` / `trigger_equity`	清算触发瞬间的账户快照
`post_uni_mmr`	该步清算完成后的 uniMMR（无仓位时为 `null`）
`liquidation_type`	`"full"` — 保险基金完全覆盖；`"adl"` — 触发了 ADL 以填补保险基金缺口

代码示例

curl

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY="limit=20&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')
curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.ztdx.io/api/v1/unified/liquidations?${QUERY}&signature=${SIGNATURE}"

Python

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"

ts = int(time.time() * 1000)
q = f"limit=20&timestamp={ts}"
sig = hmac.new(API_SECRET.encode(), q.encode(), hashlib.sha256).hexdigest()
r = requests.get(
    f"https://api.ztdx.io/api/v1/unified/liquidations?{q}&signature={sig}",
    headers={"X-MBX-APIKEY": API_KEY},
)
for liq in r.json()["liquidations"]:
    print(f"{liq['created_at']}  {liq['symbol']} {liq['side']} "
          f"pnl={liq['pnl_realized']} type={liq['liquidation_type']}")

HTTP 请求​

请求参数​

响应示例​

字段说明​

相关接口​

代码示例​

curl​

Python​