获取逐仓强平历史
限速规则 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"
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
symbol | String | 是 | 交易对 |
startTime | String | 是 | 开始时间,Unix毫秒时间戳 |
endTime | String | 否 | 结束时间,Unix毫秒时间戳 开始和结束时间的最大间隔为90天 |
limit | String | 否 | 查询条数 默认值为100条,最大值为500条 |
idLessThan | String | 否 | 用于翻页。首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最后一条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"
}
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
resultList | List | 列表 |
> symbol | String | 交易对名称 |
> liqId | String | 强平ID |
> liqStartTime | String | 强平开始时间 |
> liqEndTime | String | 强平结束时间 |
> liqRiskRatio | String | 强平时风险率 |
> totalAssets | String | 强平时总资产 以USDT为单位 |
> totalDebt | String | 强平时总欠款 以USDT为单位 |
> liqFee | String | 强平手续费 |
> cTime | String | 创建时间,毫秒时间戳 |
> uTime | String | 更新时间,毫秒时间戳 |
maxId | String | 本次查询结果最大的ID |
minId | String | 本次查询结果最小的ID,下次查询时入参使用本值 |