WebSocket

Connexion, abonnement et battement de cœur

Connectez-vous à 6MM WebSocket streams, abonnez-vous aux sujets, maintenez les connexions vivantes et traitez les enveloppes de messages en toute sécurité.

Afficher en Markdown

Utilisez WebSocket flux pour les données de marché et les mises à jour privées de l’état des utilisateurs qui doivent rester à jour sans sondage.

Connexion URL

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

Les flux privés nécessitent un contexte d’authentification tel qu’un listenKey ou un jeton d’accès tel que décrit dans la documentation du canal privé.

Abonnez-vous

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

Accusé de réception d’abonnement réussi :

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

Désabonnement

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

Ping d’application

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

Enveloppe de messages

Les campagnes publiques utilisent une enveloppe cohérente :

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

Recommandations opérationnelles

  • Générer un id unique côté client pour chaque demande d’abonnement, de désabonnement et de ping.
  • Considérer la reconnexion comme une nouvelle session et s’abonner à nouveau aux sujets requis.
  • Valider que le topic retourné correspond au canal attendu par votre service.
  • Garder le traitement des messages idempotent lorsque des ordres privés ou des événements de compte sont impliqués.
  • Modifications de l’état de connexion du journal, accusés de réception d’abonnement et déconnexions anormales.

Flux de reconnexion

  1. Fermer ou jeter la prise précédente et créer une nouvelle connexion.
  2. Réauthentifier les flux privés avec un listenKey ou un jeton d’accès valide.
  3. Réabonnez-vous à tous les sujets requis et attendez les remerciements réussis.
  4. Remplacer l’état local du carnet d’ordres par un nouvel instantané avant d’appliquer des mises à jour incrémentales.
  5. Concilier les ordres ouverts, les positions et les soldes par REST si des événements privés ont pu être manqués.

Utilisez un backoff exponentiel borné avec gigue pour les tentatives de reconnexion. Un client qui se reconnecte continuellement devrait alerter les opérateurs au lieu de réessayer indéfiniment sans visibilité.

Battement de cœur et connexions fades

  • Suivre le dernier message entrant et la confirmation réussie du ping.
  • Utiliser l’intervalle des battements de cœur et le seuil d’inactivité approuvés pour l’environnement de production.
  • Considérer une connexion comme obsolète lorsque le seuil configuré est dépassé, même si le socket TCP semble toujours ouvert.
  • Ne pas réutiliser les abonnements d’un ancien socket ; Réabonnez-vous explicitement après chaque reconnexion.