获取历史持仓

获取历史持仓

获取历史持仓列表。

请求地址

GET /deepcoin/account/positions-history

请求参数

字段名	是否必填	类型	字段描述
instType	是	string	产品类型 合约: SWAP
instId	否	string	产品 ID
mgnMode	否	string	保证金模式 全仓: cross 逐仓: isolated
mrgPosition	否	string	合并仓位 合仓: merge 分仓: split
posId	否	string	仓位 ID
startTime	否	string	开始时间，Unix 时间戳格式的毫秒数
endTime	否	string	结束时间，Unix 时间戳格式的毫秒数
limit	否	string	返回结果数量，默认 100，最大 100

响应参数

字段名	类型	字段描述
instType	string	产品类型
instId	string	产品 ID
mgnMode	string	保证金模式
mrgPosition	string	合约仓位类型 合仓: merge 分仓: split
posId	string	仓位 ID
posSide	string	持仓方向 多: long 空: short
avgPx	string	开仓均价
closeAvgPx	string	平仓均价
pos	string	持仓数量，单位: 张
closePos	string	已平仓数量，单位: 张
pnl	string	收益
fee	string	手续费；历史持仓手续费缺失时，会基于历史成交手续费估算
fundingFee	string	资金费
lever	string	杠杆倍数
ccy	string	保证金币种
cTime	string	持仓创建时间，Unix 时间戳格式的毫秒数
uTime	string	最近一次持仓更新时间，Unix 时间戳格式的毫秒数

响应示例

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "instType": "SWAP",
            "instId": "BTC-USDT-SWAP",
            "mgnMode": "cross",
            "mrgPosition": "merge",
            "posId": "1000596260760627",
            "posSide": "long",
            "avgPx": "87621.8",
            "closeAvgPx": "87688.4",
            "pos": "3101",
            "closePos": "3101",
            "pnl": "206.79299996",
            "fee": "54.36372732",
            "fundingFee": "0",
            "lever": "10",
            "ccy": "USDT",
            "cTime": "1763569021000",
            "uTime": "1764836861000"
        }
    ]
}