跳到主要内容

获取合约历史持仓列表

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"

请求参数

参数名参数类型是否必须描述
symbolString交易币对
productTypeString产品类型,默认USDT-FUTURES, 如果传了symbol,则此字段失效
USDT-FUTURES USDT专业合约
COIN-FUTURES 混合合约
USDC-FUTURES USDC专业合约
SUSDT-FUTURES USDT专业合约模拟盘
SCOIN-FUTURES 混合合约模拟盘
SUSDC-FUTURES USDC专业合约模拟盘
idLessThanString请求此ID之前(更旧的数据)的分页内容,传的值为对应接口的 endId。
startTimeString开始时间戳
Unix时间戳的毫秒数格式,如 1597026383085
(时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。)
endTimeString结束时间戳
Unix时间戳的毫秒数格式,如 1597026383085
(时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。)
limitString查询条数 默认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"
}
}

返回参数

返回字段参数类型字段说明
listArray历史持仓数据
>positionIdStringID
>symbolString币对名称
>marginCoinString保证金币种
>holdSideString持仓方向
long: 多仓
short: 空仓
>openAvgPriceString开仓均价
>closeAvgPriceString平仓均价
>marginModeString保证金模式
isolated: 逐仓
crossed: 全仓
>openTotalPosString累计开仓数量
>closeTotalPosString累计已平仓数量
>pnlString已实现盈亏
>netProfitString净盈亏
>totalFundingString累计资金费用
>openFeeString仓位开仓总手续费
>closeFeeString仓位平仓总手续费
>uTimeString最近更新时间
>cTimeString创建时间 时间戳 毫秒
集合中从最新时间开始降序。
endIdString最后的数据id。id值为跟踪单号,用于根据idLessThan查询