历史持仓频道

描述

订阅仓位频道

推送规则：仓位完全平仓时

请求示例

{
    "args":[
        {
            "channel":"positions-history",
            "instId":"default",
            "instType":"USDT-FUTURES"
        }
    ],
    "op":"subscribe"
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作, subscribe unsubscribe
args	List<Object>	是	请求订阅的频道列表
> channel	String	是	频道名
> instType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
> instId	String	是	交易对名称，default表示全部交易对，目前只支持default

订阅返回示例

{
    "event":"subscribe",
    "arg":{
        "instType":"USDT-FUTURES",
        "channel":"positions-history",
        "instId":"default"
    }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> channel	String	频道名
> instType	String	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
> instId	String	default
code	String	错误码，错误时才会返回
msg	String	错误消息

推送返回示例

{
    "action":"snapshot",
    "arg":{
        "instType":"USDT-FUTURES",
        "channel":"positions-history",
        "instId":"default"
    },
    "data":[
        {
            "posId":"1",
            "instId":"BTCUSDT",
            "marginCoin":"USDT",
            "marginMode":"crossed",
            "holdSide":"short",
            "posMode":"one_way_mode",
            "openPriceAvg":"20000.0",
            "closePriceAvg":"26221.0",
            "openSize":"0.010",
            "closeSize":"0.010",
            "achievedProfits":"-62.21000000",
            "settleFee":"-0.02277989",
            "openFee":"-0.12000000",
            "closeFee":"-0.15732600",
            "cTime":"1696907951177",
            "uTime":"1697090609976"
        }
    ],
    "ts":1697099840122
}

推送数据参数

返回字段	参数类型	字段说明
action	String	'snapshot'
arg	Object	订阅成功的频道
> channel	String	频道名
> instType	String	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
> instId	String	default
data	List<Object>	订阅的数据
> posId	String	持仓ID
> instId	String	产品id，交割合约参考：https://www.bitget.com/zh-CN/api-doc/common/release-note
> marginCoin	String	占用保证金的币种
> marginMode	String	保证金模式 fixed: 逐仓 crossed: 全仓
> holdSide	String	持仓方向
> posMode	String	持仓模式
> openPriceAvg	String	开仓平均价
> closePriceAvg	String	平仓平均价
> openSize	String	已开仓量
> closeSize	String	已平仓量
> achievedProfits	String	已实现盈亏
> settleFee	String	资金费用
> openFee	String	仓位开仓总手续费
> closeFee	String	仓位平仓总手续费
> cTime	String	持仓创建时间，Unix时间戳的毫秒数格式，如 1597026383085
> uTime	String	最近一次持仓更新时间，Unix时间戳的毫秒数格式，如 1597026383085