プライベートユーザーチャネル

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://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 プライベートストリームは別々のスキーマを使用します。クライアントは各スキーマを独立して解析し、フィールド名が同一であると想定してはいけません。

共通の違い

ドメインREST フィールドWebSocket フィールド
修道会の状況statusorderStatus
凍結残高frozenMarginfrozenBalance
マージンモードmarginModemarginModeはポジションや流れに文字列として戻ってきました

回復と和解

  • listenKey の期限切れ前に更新し、更新が失敗した場合は新たに作成する。
  • 再接続、再認証、新しいソケットを新しいイベントセッションとして扱う。
  • パートナー残高や注文記録を変更する前にイベントを重複解除する。
  • イベントが見逃された可能性がある場合、クエリ 命令, ポジション、および 会計の状態 RESTを通じて。
  • 従う つながりと心拍ガイド 再試行および古い接続処理のために。