Private User Channel

Als Markdown anzeigen

Erstellen Sie zuerst eine listenKey :

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

Antwortbeispiel:

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

listenKey ist standardmäßig 60 Minuten gültig. Eine Verlängerung alle 30 Minuten wird empfohlen.

Erneuern

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

Schließen

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

Verbinden Sie sich mit privater WebSocket

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

Kompatible JWT Verbindungsmethode:

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

Nach erfolgreicher Authentifizierung abonniert der Server automatisch die Verbindung zum privaten Kanal des aktuellen Nutzers. Ein manuelles Abonnement ist nicht erforderlich.

Erfolgreiche Authentifizierungsbestätigung:

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

Häufige private Ereignisse

EreignisBeschreibung
ORDER_TRADE_UPDATEOrderstatusänderungen, einschließlich neuer Order, Änderung, Trade und Stornierung
ACCOUNT_UPDATEKontostand- und Positionsänderungen

Privater Push-Message-Wrapper:

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

REST Abfrage-Endpunkte und WebSocket private Streams verwenden separate Schemata. Clients sollten jedes Schema unabhängig parsen und nicht annehmen, dass Feldnamen identisch sind.

Gemeinsame Unterschiede

DomäneREST FeldWebSocket Feld
Status des OrdensstatusorderStatus
Eingefrorenes GleichgewichtfrozenMarginfrozenBalance
Margin-ModusmarginModemarginMode, wurde als Saite in Positionen und Strömen zurückgegeben

Genesung und Versöhnung

  • Erneuern Sie die listenKey vor Ablauf und erstellen Sie eine neue, falls die Verlängerung fehlschlägt.
  • Wiederverbinden, erneut authentifizieren und den neuen Socket als neue Ereignissitzung behandeln.
  • Deduplizieren von Ereignissen, bevor Partnersalden oder Orderaufzeichnungen geändert werden.
  • Wenn Ereignisse übersehen wurden, fragen Sie Befehle, Positionen und Kontozustand über REST.
  • Folgen Sie dem Verbindungs- und Herzschlag-Leitfaden für den Wiederholungs- und Stale-Connection-Handling.