# 持仓频道
### 描述
订阅仓位频道
以下事件发生时将推送数据：
1. 下开、平仓委托
2. 开、平仓委托成交
3. 撤单
```json title="请求示例"
{
"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` |
```json title="订阅返回示例"
{
"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 | 错误消息 |
```json title="推送返回示例"
{
"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",
"markPrice": "2500",
"cashDividend": "0",
"assetMode": "union",
"uTime": "1695711602568",
"autoMargin": "off"
}
],
"ts": 1695717430441
}
```
### 推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|:------------------------| :---- |:----------------------------------------------------------------------------------|
| action | String | 推送动作, 'snapshot' |
| arg | Object | 订阅成功的频道 |
| > channel | String | 频道名 |
| > instType | String | 产品类型
`USDT-FUTURES` U本位合约
`COIN-FUTURES` 币本位合约
`USDC-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 | 已扣手续费，仓位存续期间扣除的交易手续费 |
| > markPrice | String | 标记价格 |
| > cashDividend | String | 现金派息，单位：USDT |
| > assetMode | String | 账户模式
`union`联合保证金
`single`单币种保证金 |
| > cTime | String | 持仓创建时间，Unix时间戳的毫秒数格式，如 1597026383085 |
| > uTime | String | 最近一次持仓更新时间，Unix时间戳的毫秒数格式，如 1597026383085 |