WebSocket

Verbindung, Abonnement & Herzschlag

Verbinden Sie sich mit 6MM WebSocket Streams, abonnieren Sie Themen, halten Sie Verbindungen lebendig und verarbeiten Sie Nachrichtenumschläge sicher.

Als Markdown anzeigen

Nutzen Sie WebSocket Streams für Marktdaten und private User-State-Updates, die ohne Umfragen aktuell bleiben müssen.

Verbindung URL

wss://ws.6mm.com/ws

Private Streams benötigen Authentifizierungskontext wie einen listenKey oder Zugriffstoken, wie in der Dokumentation des privaten Kanals beschrieben.

Abonnieren

1{ "id": "1772007814666", "op": "subscribe", "args": ["market.depth.BTCUSDT"] }

Erfolgreiche Abonnementbestätigung:

1{
2  "id": "1772007814666",
3  "event": "subscribe",
4  "success": true,
5  "data": ["market.depth.BTCUSDT"]
6}

Abmelden

1{ "id": "1772007814667", "op": "unsubscribe", "args": ["market.depth.BTCUSDT"] }

Anwendungsping

1{ "id": "1772007814668", "op": "ping", "args": [] }

Nachrichtenumschlag

Öffentliche Vorstöße nutzen eine einheitliche Grenze:

1{
2  "topic": "market.depth.BTCUSDT",
3  "event": "data",
4  "ts": 1772007815000,
5  "data": {}
6}

Betriebsempfehlungen

  • Generiere eine eindeutige clientseitige id für jede Abonnieren-, Abmelde- und Ping-Anfrage.
  • Behandeln Sie die Wiederverbindung als neue Sitzung und abonnieren Sie erneut erforderliche Themen.
  • Überprüfen Sie, dass die zurückgegebene topic mit dem Kanal übereinstimmt, den Ihr Dienst erwartet.
  • Halte die Nachrichtenverarbeitung idempotent, wenn private Bestellungen oder Kontoereignisse betroffen sind.
  • Protokollieren Sie Verbindungszustandsänderungen, Abonnementbestätigungen und abnormale Verbindungsabbrüche.

Workflow Wiederverbinden

  1. Schließe oder entsorge die vorherige Buchse und stelle eine neue Verbindung her.
  2. Private Streams mit einem gültigen listenKey oder Zugriffstoken erneut authentifizieren.
  3. Abonniere jedes erforderliche Thema erneut und warte auf erfolgreiche Danksagungen.
  4. Ersetze den lokalen Orderbuch-Status durch einen neuen Snapshot, bevor du inkrementelle Updates anwendest.
  5. Offene Befehle, Positionen und Bilanzen durch REST abzustimmen, falls private Ereignisse übersehen wurden.

Nutze bounded exponential backoff mit Jitter für Wiederverbindungsversuche. Ein kontinuierlich wiederverbundener Client sollte die Bediener alarmieren, anstatt es unbegrenzt ohne Sicht zu versuchen.

Herzschlag und abgestandene Verbindungen

  • Verfolgen Sie die aktuellste eingehende Nachricht und die erfolgreiche Ping-Bestätigung.
  • Verwenden Sie das für die Produktionsumgebung genehmigte Herzschlagintervall und Leerlaufschwelle.
  • Behandle eine Verbindung als veraltet, wenn der konfigurierte Schwellenwert überschritten wird, selbst wenn der TCP Sockel noch offen erscheint.
  • Keine Abonnements von einem alten Socket wiederverwenden; Abonniere dich nach jeder Wiederverbindung ausdrücklich wieder.