获取合约历史持仓列表

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": "fixed",
            "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	保证金模式 fixed: 逐仓 crossed: 全仓
>openTotalPos	String	累计开仓数量
>closeTotalPos	String	累计已平仓数量
>pnl	String	已实现盈亏
>netProfit	String	净盈亏
>totalFunding	String	累计资金费用
>openFee	String	仓位开仓总手续费
>closeFee	String	仓位平仓总手续费
>uTime	String	最近更新时间
>cTime	String	创建时间 时间戳 毫秒 集合中从最新时间开始降序。
endId	String	最后的数据id。id值为跟踪单号，用于根据idLessThan查询