私有用户频道

以 Markdown 格式查看

先创建 listenKey

1POST /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 分钟续期一次。

续期:

1PUT /v1/private/user/listen-key
2Content-Type: application/json
1{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

关闭:

1DELETE /v1/private/user/listen-key
2Content-Type: application/json
1{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

连接私有 WebSocket:

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

兼容 JWT 连接方式:

wss://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 字段
订单状态statusorderStatus
冻结余额frozenMarginfrozenBalance
保证金模式marginModemarginMode,持仓和推送使用字符串