私人用戶通道

先建立 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" }

常見的私人活動

私人推送訊息包裝器：

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

REST 查詢端點與 WebSocket 私有串流使用不同的結構結構。用戶端應獨立解析每個結構，且不應假設欄位名稱相同。

共同差異

復原與和解

• 在 listenKey 到期前續約，若續期失敗則重新建立新。

• 重新連接、重新認證，並將新套接字視為新的事件會話。

• 在更改合作夥伴餘額或訂單紀錄前，先進行重複事件。

• 若事件可能未被漏接，請查詢 [orders]（/developer-api/rest-api/order）、[positions]（/developer-api/rest-api/position）、以及[account state]（/developer-api/rest-api/user-and-account） 透過 REST查詢。

• 請依照[連線與心跳指南]（/developer-api/websocket/connection-subscription-and-heartbeat）進行重試及連線過期處理。

  相關頁面

• 訂單

• 倉位

• 使用者與帳號

• 連結、訂閱與心跳