跳到主要内容

获取逐仓强平历史

限速规则 10次/1s (UID)

描述

HTTP请求

  • GET /api/v2/margin/isolated/liquidation-history
请求示例
curl "https://api.bitget.com/api/v2/margin/isolated/liquidation-history?symbol=BTCUSDT&startTime=1692690126000"  -H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

请求参数

参数名参数类型是否必须描述
symbolString交易对
startTimeString开始时间,Unix毫秒时间戳
endTimeString结束时间,Unix毫秒时间戳
开始和结束时间的最大间隔为90天
limitString查询条数
默认值为100条,最大值为500条
idLessThanString用于翻页。首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最后一条liqId,结果会返回小于该值的数据;可以缩短查询响应时间
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1695624945382,
"data": {
"resultList": [
{
"liqId": "1",
"symbol": "BTCUSDT",
"liqStartTime": "1653453245342",
"liqEndTime": "16312423423432",
"liqRiskRatio": "1.01",
"totalAssets": "1242.34",
"totalDebt": "1100",
"liqFee": "1.2",
"cTime": "1653453245342",
"uTime": "1692690126000"
}
],
"maxId": "1",
"minId": "1"
}
}

返回参数

返回字段参数类型字段说明
resultListList列表
> symbolString交易对名称
> liqIdString强平ID
> liqStartTimeString强平开始时间
> liqEndTimeString强平结束时间
> liqRiskRatioString强平时风险率
> totalAssetsString强平时总资产
以USDT为单位
> totalDebtString强平时总欠款
以USDT为单位
> liqFeeString强平手续费
> cTimeString创建时间,毫秒时间戳
> uTimeString更新时间,毫秒时间戳
maxIdString本次查询结果最大的ID
minIdString本次查询结果最小的ID,下次查询时入参使用本值