持仓频道

描述

订阅仓位频道

以下事件发生时将推送数据：

下开、平仓委托
开、平仓委托成交
撤单

请求示例
{
    "op": "subscribe",
    "args": [
        {
            "instType": "USDT-FUTURES",
            "channel": "positions",
            "instId": "default"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作, subscribe unsubscribe
args	List<Object>	是	请求订阅的频道列表
> channel	String	是	频道名
> instType	String	是	产品类型
> instId	String	是	交易对名称，`default`表示全部交易对，目前只支持`default`

订阅返回示例
{
    "event": "subscribe",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "positions",
        "instId": "default"
    }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> channel	String	频道名
> instType	String	产品类型
> instId	String	`default`
code	String	错误码，错误时才会返回
msg	String	错误消息

推送返回示例
{
    "action": "snapshot",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "positions",
        "instId": "default"
    },
    "data": [
        {
            "posId": "1",
            "instId": "ETHUSDT",
            "marginCoin": "USDT",
            "marginSize": "9.5",
            "marginMode": "crossed",
            "holdSide": "short",
            "posMode": "hedge_mode",
            "total": "0.1",
            "available": "0.1",
            "frozen": "0",
            "openPriceAvg": "1900",
            "leverage": 20,
            "achievedProfits": "0",
            "unrealizedPL": "0",
            "unrealizedPLR": "0",
            "liquidationPrice": "5788.108475905242",
            "keepMarginRate": "0.005",
            "marginRate": "0.004416374196",
            "cTime": "1695649246169",
            "breakEvenPrice": "24778.97",
            "totalFee": "1.45",
            "deductedFee": "0.388",
            "uTime": "1695711602568",
            "autoMargin": "off"
        }
    ],
    "ts": 1695717430441
}

推送数据参数

返回字段	参数类型	字段说明
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	占用保证金的币种
> marginSize	String	占用保证金(数量)
> marginMode	String	保证金模式
> holdSide	String	持仓方向
> posMode	String	持仓模式
> total	String	持仓数量
> available	String	可平仓数量
> frozen	String	冻结数量
> openPriceAvg	String	开仓平均价
> leverage	String	杠杆倍数
> achievedProfits	String	已实现盈亏
> unrealizedPL	String	未实现盈亏
> unrealizedPLR	String	未实现盈亏率
> liquidationPrice	String	预估强平价
> keepMarginRate	String	维持保证金率
> isolatedMarginRate	String	逐仓时，实际保证金率
> marginRate	String	保证金占用率
> breakEvenPrice	String	仓位盈亏平衡价
> totalFee	String	资金费用，仓位存续期间，资金费用的累加值，初始值为空，表示还没收取过资金费
> deductedFee	String	已扣手续费，仓位存续期间扣除的交易手续费
> cTime	String	持仓创建时间，Unix时间戳的毫秒数格式，如 1597026383085
> uTime	String	最近一次持仓更新时间，Unix时间戳的毫秒数格式，如 1597026383085

持仓频道

描述​

请求参数​

返回参数​

推送数据参数​

您的阅读体验如何？

描述

请求参数

返回参数

推送数据参数