持仓更新（私有）

合约特有私有频道，认证后自动订阅。字段名使用短名称以优化传输体积。

• 频道：position
• 推送频率：实时（无节流）
• 权限：私有（需要 auth）

认证

{
  "op": "auth",
  "args": ["<jwt_token>"]
}

认证成功后会自动订阅 order、balance 和 position。

推送示例

{
  "ch": "position",
  "d": {
    "i": 12345,
    "s": "BTC_USDT",
    "ps": 1,
    "mm": 2,
    "l": 10,
    "q": "0.5",
    "ep": "49000",
    "mp": "49500",
    "pv": "24750",
    "im": "2475",
    "m": "247.5",
    "mr": "0.01",
    "up": "250",
    "upp": "10.10",
    "roe": "10.10",
    "lp": "44550",
    "of": "12.25",
    "cf": "0",
    "ct": 1768205315166,
    "ut": 1768205315166,
    "ts": 1768205315166
  }
}

推送字段

字段	类型	说明
i	number	仓位 ID
s	string	交易对
ps	number	仓位方向：1=做多，2=做空
mm	number	保证金模式：1=逐仓，2=全仓
l	number	杠杆倍数
q	string	持仓数量
ep	string	开仓均价
mp	string	标记价格（实时）
pv	string	仓位价值（实时 = 持仓数量 × 标记价格）
im	string	初始保证金
m	string	维持保证金
mr	string	保证金率（实时）
up	string	未实现盈亏（实时）
upp	string	未实现盈亏率（实时，百分比）
roe	string	回报率 ROE（实时）
lp	string	强平价格
of	string	开仓手续费
cf	string	平仓手续费
ct	number	创建时间（毫秒）
ut	number	更新时间（毫秒）
ts	number	推送时间戳（毫秒）

说明

• 标记价格变化时会推送更新（仓位价值、保证金率、未实现盈亏等会随之变化）
• 仓位数量、杠杆、保证金模式等变化时推送
• 字段名采用短名称以优化传输性能