Reconnexion WebSocket de WEEX : rétablir les mises à jour des ordres

By: WEEX
|
0

Reconnexion WebSocket de WEEX : rétablir les mises à jour des ordres

Après une déconnexion du WebSocket de WEEX, rétablissez la connexion privée à l’aide d’un nouvel horodatage et d’une nouvelle signature, réabonnez-vous à orders et confirmez que l’abonnement a réussi. Utilisez ensuite des requêtes REST pour réconcilier l’état des ordres pendant l’interruption avant de laisser à nouveau une stratégie s’appuyer sur ces données.

Par exemple, un ordre ouvert avant la déconnexion peut avoir été exécuté avant la reconnexion. La réception des seules nouvelles mises à jour ne vous indique pas tout ce qui s’est passé pendant l’interruption. La procédure de récupération doit couvrir à la fois la connexion et tout écart entre les enregistrements d’ordres locaux et l’état réel du compte.

Conservez les informations nécessaires à la récupération

Surveillez les fermetures de connexion, les erreurs réseau et les échecs de réponse aux signaux de présence. En cas d’interruption, notez l’heure de la dernière réception réussie et conservez les ID d’ordre connus, les identifiants d’ordre client et l’état local. Vous utiliserez ces informations pour interroger les ordres par la suite.

Marquez l’état des ordres comme étant en attente de réconciliation et mettez en pause les actions automatisées qui nécessitent une vue complète pour fonctionner en toute sécurité. Reconnectez-vous avec une temporisation progressive plafonnée et une gigue afin que les processus n’effectuent pas de tentatives répétées et simultanées. Les limites indiquées dans la documentation comprennent 300 demandes de connexion par IP toutes les cinq minutes, jusqu’à 20 connexions simultanées par IP et 240 opérations d’abonnement par connexion et par heure. Choisissez vos paramètres de temporisation en tenant compte de ces limites.

Réauthentifiez-vous sur la connexion privée appropriée

Les mises à jour des ordres utilisent le canal privé correspondant au produit concerné :

ProduitAdresse WebSocket privée
Spotwss://ws-spot.weex.com/v3/ws/private
Futureswss://ws-contract.weex.com/v3/ws/private

La négociation initiale nécessite User-Agent, ACCESS-KEY, ACCESS-PASSPHRASE, ACCESS-TIMESTAMP et ACCESS-SIGN. Utilisez un horodatage en millisecondes correspondant à la valeur de la signature. La documentation indique qu’il expire au bout de 30 secondes ; générez donc de nouvelles données d’authentification pour chaque nouvelle connexion.

Le message de signature WebSocket est le suivant :

timestamp + "/v3/ws/private"

Appliquez HMAC-SHA256 avec le SecretKey, puis encodez le résultat en Base64 pour ACCESS-SIGN. Cette méthode utilise le format de signature WebSocket, et non la construction complète d’une requête REST. Consultez la documentation WebSocket Spot et la documentation WebSocket Futures pour connaître les détails de connexion.

Réabonnez-vous aux ordres et vérifiez l’accusé de réception

Envoyez cette requête sur la nouvelle connexion privée :

{"method":"SUBSCRIBE","params":["orders"],"id":1}

Les références du canal d’ordres Spot et du canal d’ordres Futures indiquent que cet accusé de réception confirme la réussite :

{"result":true,"id":1}

Associez la réponse à la requête d’abonnement à l’aide de id et examinez msg en cas d’échec. Il s’agit d’un identifiant de requête, et non d’un ID d’ordre. Se contenter de consigner « WebSocket connecté » ne permettrait pas de détecter une connexion réussie suivie d’un échec d’abonnement.

La connexion doit également gérer les signaux de présence au niveau applicatif de WEEX. Un ping privé est présenté sous la forme {"type":"ping","time":"1693208170000"} ; les canaux publics utilisent event. La réponse indiquée dans la documentation est :

{"method":"PONG","id":1}

La gestion des ping et pong au niveau protocolaire par une bibliothèque ne remplace pas le traitement de ces messages JSON. La documentation indique que le serveur se déconnecte après plus de 10 ping sans réponse, mais ne fournit aucun intervalle universel entre les signaux de présence permettant de calculer un délai de déconnexion fixe.

Réconciliez les données via REST, y compris les ordres qui ne sont plus ouverts

À la reprise des événements d’ordres entrants, mettez-les en mémoire tampon pendant que vous interrogez les ordres ouverts, l’historique des ordres et les détails des ordres connus. Comparez les statuts, les exécutions cumulées et les heures de mise à jour. Cette approche de récupération côté client vise à repérer les changements qui ont pu être manqués pendant l’interruption ; ne partez pas du principe que le serveur renvoie tous les messages historiques.

Informations à réconcilierChemin GET SpotChemin GET Futures
Ordres ouverts/api/v3/openOrders/capi/v3/openOrders
Historique des ordres/api/v3/allOrders/capi/v3/order/history
Détails d’un ordre/api/v3/order/capi/v3/order

Une requête portant uniquement sur les ordres ouverts ne couvre pas un cas important : un ordre exécuté ou annulé pendant l’interruption peut ne plus y figurer. C’est pourquoi l’historique des ordres et les détails des ordres connus doivent faire partie du processus de récupération.

Respectez les plages temporelles, les champs obligatoires et la pagination propres à chaque point de terminaison. Pour le Spot, allOrders nécessite par exemple symbol, tandis que l’historique Futures propose page et limit. Suivez les règles de l’historique Spot et de l’historique Futures pour récupérer les enregistrements pertinents avant de fusionner les événements mis en mémoire tampon.

Les événements en double ne doivent pas déclencher plusieurs fois des opérations comptables ou des actions métier, et les événements plus anciens ne doivent pas écraser un état plus récent confirmé. Effectuez une nouvelle requête lorsque les mises à jour REST et celles du flux ne concordent pas. Le champ de message v est défini comme une version du compte ; la documentation ne garantit ni une séquence d’ordres continue ni un curseur de reprise. Un écart de version ne permet donc pas, à lui seul, d’identifier un ordre manquant.

Si les mises à jour n’arrivent toujours pas, examinez le symptôme

SymptômePoints à vérifier
La négociation initiale renvoie 403Vérifiez User-Agent, puis les autres champs d’authentification. La FAQ officielle indique que le pare-feu bloque les connexions auxquelles cet en-tête fait défaut.
Connexion établie, mais aucun accusé de réception d’abonnement réussiVérifiez l’adresse privée, la requête orders et les éventuelles erreurs dans l’accusé de réception.
Abonnement effectué, mais aucun nouvel événement d’ordreVérifiez les signaux de présence et l’activité réelle du compte. Un flux silencieux est normal en l’absence de nouveaux changements d’ordres.
Le SDK s’est reconnecté, mais l’état local reste différentVérifiez la réconciliation REST pour couvrir l’interruption. La reconnexion automatique ne garantit pas que l’état des ordres a été réconcilié.

Pendant toute la procédure de récupération, ne considérez pas l’absence de réponse comme la preuve qu’un ordre a échoué et ne renvoyez pas tous les ordres. Établissez l’état réel du compte, résolvez les écarts, puis reprenez les stratégies qui en dépendent.

Pour obtenir une aide supplémentaire, utilisez les liens d’assistance de la FAQ officielle de l’API et fournissez les heures de connexion, les codes de statut et des journaux expurgés de toute donnée sensible afin de montrer à quel stade la récupération s’est interrompue.

Articles connexes
Partager
copy

À la hausse

iconiconiconiconiconiconiconicon
Assistance client:@weikecs
Collaborations commerciales:@weikecs
Trading quantitatif/Market makers:bd@weex.com
Programme VIP:support@weex.com