获取合约历史持仓列表
20次/S 根据uid限频
描述
查询历史持仓列表 (只能查询最近3个月的历史持仓数据)
HTTP请求
- GET /api/v2/mix/position/history-position
请求示例
curl "https://api.bitget.com/api/v2/mix/position/history-position?productType=USDT-FUTURES" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
symbol | String | 否 | 交易币对 |
productType | String | 否 | 产品类型,默认USDT-FUTURES , 如果传了symbol,则此字段失效USDT-FUTURES USDT专业合约COIN-FUTURES 混合合约USDC-FUTURES USDC专业合约SUSDT-FUTURES USDT专业合约模拟盘SCOIN-FUTURES 混合合约模拟盘SUSDC-FUTURES USDC专业合约模拟盘 |
idLessThan | String | 否 | 请求此ID之前(更旧的数据)的分页内容,传的值为对应接口的 endId。 |
startTime | String | 否 | 开始时间戳 Unix时间戳的毫秒数格式,如 1597026383085 (时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。) |
endTime | String | 否 | 结束时间戳 Unix时间戳的毫秒数格式,如 1597026383085 (时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。) |
limit | String | 否 | 查询条数 默认20,最大100 |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1312312312321,
"data": {
"list":[{
"positionId": "xxxxxxxxxxx",
"marginCoin": "USDT",
"symbol": "BTCUSDT",
"holdSide": "long",
"openAvgPrice": "32000",
"closeAvgPrice": "32500",
"marginMode": "isolated",
"openTotalPos": "0.01",
"closeTotalPos": "0.01",
"pnl": "14.1",
"netProfit": "12.1",
"totalFunding": "0.1",
"openFee": "0.01",
"closeFee": "0.01",
"cTime": "1988824171000",
"uTime": "1988824171000"
}],
"endId":"23423432423423234"
}
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
list | Array | 历史持仓数据 |
>positionId | String | ID |
>symbol | String | 币对名称 |
>marginCoin | String | 保证金币种 |
>holdSide | String | 持仓方向 long: 多仓 short: 空仓 |
>openAvgPrice | String | 开仓均价 |
>closeAvgPrice | String | 平仓均价 |
>marginMode | String | 保证金模式 isolated: 逐仓 crossed: 全仓 |
>openTotalPos | String | 累计开仓数量 |
>closeTotalPos | String | 累计已平仓数量 |
>pnl | String | 已实现盈亏 |
>netProfit | String | 净盈亏 |
>totalFunding | String | 累计资金费用 |
>openFee | String | 仓位开仓总手续费 |
>closeFee | String | 仓位平仓总手续费 |
>uTime | String | 最近更新时间 |
>cTime | String | 创建时间 时间戳 毫秒 集合中从最新时间开始降序。 |
endId | String | 最后的数据id。id值为跟踪单号,用于根据idLessThan查询 |