私有用户频道

先创建 listenKey：

1 POST /v1/private/user/listen-key

响应示例：

1 {
2   "code": 0,
3   "message": "success",
4   "data": {
5     "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c",
6     "expireAt": 1777539918867
7   },
8   "requestId": "req-listen-key"
9 }

listenKey 默认有效期为 60 分钟，建议每 30 分钟续期一次。

续期

1 PUT /v1/private/user/listen-key
2 Content-Type: application/json

1 { "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

关闭

1 DELETE /v1/private/user/listen-key
2 Content-Type: application/json

1 { "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

连接私有 WebSocket

wss://ws.6mm.com/ws?listenKey=YOUR_LISTEN_KEY

兼容 JWT 连接方式：

wss://ws.6mm.com/ws?token=YOUR_ACCESS_TOKEN

鉴权成功后，服务端会自动订阅当前用户私有频道，无需手动订阅。

鉴权成功回执：

1 { "event": "auth", "success": true, "data": "1188041528" }

常用私有事件

事件	说明
`ORDER_TRADE_UPDATE`	订单状态变更，包括挂单、改单、成交、撤单
`ACCOUNT_UPDATE`	账户余额和持仓变化

私有推送外层格式：

1 {
2   "topic": "user.5794",
3   "ts": 1771047000000,
4   "data": {
5     "eventType": "ORDER_TRADE_UPDATE"
6   }
7 }

REST 查询接口和 WebSocket 私有推送是两套独立 schema，客户端应按各自字段解析，不要假设字段完全同名。

常见差异

域	REST 字段	WebSocket 字段
订单状态	`status`	`orderStatus`
冻结余额	`frozenMargin`	`frozenBalance`
保证金模式	`marginMode`	`marginMode`，持仓和推送使用字符串

恢复与对账

listenKey 到期前主动续期；续期失败时创建新 listenKey。
重连后重新鉴权，并把新连接视为新的事件会话。
更新合作方余额或订单记录前，先对事件去重。
如果可能遗漏事件，通过 REST 查询订单、仓位和账户状态完成对账。
重试和失效连接处理参见连接订阅与心跳。