La validation temporelle des API Futures de Gate est une fonctionnalité de vérification de l’heure ajoutée par Gate côté moteur d’appariement (ME) de ses API de trading de contrats. Deux en-têtes HTTP fonctionnent conjointement pour confirmer qu’une requête a été envoyée dans un délai défini. Le client définit X-Gate-Client-Send-Us sur son horodatage d’envoi en microsecondes et X-Gate-Timeout-Window-Us sur la fenêtre de validité maximale, également en microsecondes. Cette mise à jour s’applique uniquement à l’architecture de trading Gate 3.0.
Ce mécanisme répond à un risque concret du trading algorithmique : une requête qui reste dans une file d’attente réseau, une nouvelle tentative lente du client ou une dérive de l’horloge peut parvenir au moteur d’appariement bien après le moment prévu par le trader. Sur les marchés de trading de contrats qui évoluent rapidement, un ordre retardé à un prix inadapté crée un risque de slippage et d’exécutions non souhaitées. La validation temporelle offre au client un moyen déclaratif d’indiquer « traiter cette requête comme non valide après N microsecondes », en plaçant le contrôle d’expiration au niveau du ME plutôt que de dépendre uniquement du timing du réseau.
Les API de trading de contrats de Gate prennent désormais en charge deux en-têtes de requête pour la validation temporelle côté moteur d’appariement (ME) : X-Gate-Client-Send-Us et X-Gate-Timeout-Window-Us, tous deux exprimés en microsecondes.
X-Gate-Client-Send-Us contient l’horodatage d’envoi du client en microsecondes depuis l’époque Unix. Le serveur compare cette valeur à sa propre horloge à la réception.
X-Gate-Timeout-Window-Us définit la fenêtre de validité maximale de la requête en microsecondes. Si le délai écoulé entre l’horodatage d’envoi et la réception par le serveur dépasse cette fenêtre, la requête est rejetée.
Les points de terminaison REST ont été lancés le 16 novembre 2026. La prise en charge de l’API WebSocket suivra le 19 novembre 2026.
Le mécanisme s’applique uniquement à l’architecture de trading Gate 3.0 pour les interfaces de trading de contrats (futures) ; les autres architectures ne prennent actuellement pas en charge cette fonctionnalité. Les étapes d’intégration sont les suivantes : synchroniser votre horloge, calculer l’horodatage d’envoi en microsecondes, définir les deux en-têtes, puis vérifier et mettre à jour votre logique d’intégration d’API conformément aux derniers noms de champs.
La validation temporelle des API Futures de Gate repose sur deux en-têtes HTTP qui permettent à un client de déclarer combien de temps une requête doit rester valide. Le mécanisme fonctionne au niveau du transport, avant que le moteur d’appariement ne traite la requête. Le serveur lit les deux en-têtes lors de chaque appel entrant à l’API de contrats, calcule la différence entre sa propre heure de réception et l’horodatage d’envoi déclaré par le client, puis compare le résultat à la fenêtre d’expiration déclarée.
X-Gate-Client-Send-Us contient l’horodatage, en microsecondes depuis l’époque Unix, auquel le client a envoyé la requête. Une valeur de 1794794400123456 correspond à un instant précis à la microseconde près. L’unité est la microseconde, et non la milliseconde ou la seconde, une erreur d’intégration courante qui génère des erreurs telles que « horodatage trop ancien » ou « horodatage trop éloigné dans le futur ».
L’en-tête indique au serveur à quel moment la requête a quitté le client. Le serveur calcule ensuite le délai écoulé en soustrayant cette valeur de son propre horodatage de réception. Si l’horloge du client n’est pas suffisamment synchronisée avec celle du serveur, le délai calculé sera erroné, même si la latence réseau était normale.
X-Gate-Timeout-Window-Us définit la fenêtre de validité maximale de la requête, en microsecondes. Le serveur rejette toute requête dont le délai écoulé dépasse cette fenêtre. Une valeur de 5000000 correspond à cinq secondes. Une valeur de 500000 correspond à une demi-seconde, soit une fenêtre plus stricte adaptée au placement d’ordres sensible à la latence.
Cet en-tête donne au client un contrôle explicite sur le degré d’ancienneté autorisé d’une requête. Une fenêtre restreinte réduit le risque d’exécution dans des conditions de marché obsolètes. Une fenêtre plus large tolère la variabilité du réseau et la dérive de l’horloge, mais laisse davantage de temps aux prix du marché pour évoluer entre l’intention du client et l’exécution par le serveur.
Sur les marchés de contrats et de futures, les prix peuvent évoluer en quelques millisecondes. Un ordre prévu pour être exécuté au prix actuel peut arriver plusieurs secondes plus tard, alors que le marché a déjà évolué. Sans validation temporelle, l’API ne peut pas déterminer si le client avait prévu ce délai ou si la requête a été rejouée, dupliquée ou bloquée dans une file d’attente.
La validation temporelle couvre trois scénarios concrets :
Pics de latence réseau. Une requête qui met plus longtemps que prévu à atteindre le serveur peut être rejetée avant son traitement par le moteur d’appariement, évitant ainsi des exécutions à des prix que le trader ne considère plus comme acceptables.
Dérive de l’horloge du client. Si l’horloge système du client est en avance ou en retard par rapport au serveur, le délai calculé sera faussé. Le client peut le détecter à partir de la réponse d’erreur et ajuster la synchronisation de son horloge.
Requêtes rejouées ou dupliquées. Une requête interceptée puis rejouée après l’expiration de sa fenêtre sera rejetée, car le serveur constatera que le délai écoulé dépasse la fenêtre déclarée. Cela ajoute un niveau de protection contre certaines attaques par rejeu, au-delà de l’authentification fondée sur les signatures.
L’annonce officielle précise que cette mise à jour renforce la capacité de vérification de l’heure côté moteur d’appariement (ME) pour les requêtes de trading de contrats. Les utilisateurs de l’architecture de trading Gate 3.0 doivent examiner et mettre à jour leur logique d’intégration d’API conformément aux derniers noms de champs afin de garantir le bon fonctionnement de la fonctionnalité de validation temporelle.
Avant de définir l’en-tête d’horodatage, assurez-vous que l’horloge de votre client est synchronisée avec une source horaire fiable. Utilisez NTP ou interrogez le point de terminaison d’heure serveur de Gate et enregistrez le décalage entre votre horloge locale et celle du serveur. Une resynchronisation périodique maintient la dérive dans des limites acceptables. La plupart des configurations NTP standard maintiennent la dérive sous quelques millisecondes, ce qui reste largement dans une fenêtre d’expiration typique de 1 à 5 secondes.
Lors de la préparation de chaque requête, capturez l’heure actuelle en microsecondes depuis l’époque Unix. La plupart des langages fournissent cette information directement :
import time
send_us = int(time.time() * 1_000_000)
const sendUs = Date.now() * 1000;
Inscrivez cette valeur dans l’en-tête X-Gate-Client-Send-Us.
Choisissez une fenêtre correspondant à la tolérance de latence de votre stratégie. Pour les stratégies de tenue de marché ou de scalping nécessitant un contrôle strict, 500000 microsecondes (0,5 seconde) constituent une valeur raisonnable. Pour les stratégies plus lentes, telles que le grid trading ou le rééquilibrage de portefeuille, 5000000 microsecondes (5 secondes) offrent une plus grande tolérance.
Inscrivez cette valeur dans l’en-tête X-Gate-Timeout-Window-Us.
Lorsque le serveur rejette une requête parce que le délai écoulé dépasse la fenêtre, l’API renvoie une réponse d’erreur. Votre client doit :
Ne réutilisez pas les en-têtes d’origine lors d’une nouvelle tentative. Chaque nouvelle requête doit contenir un nouvel horodatage et une nouvelle fenêtre.
Au fil du temps, les horloges des clients peuvent dériver par rapport au serveur. Planifiez des synchronisations NTP périodiques ou interrogez le point de terminaison d’heure serveur de Gate, puis ajustez votre décalage. Vous pouvez également ajouter une vérification légère de l’état à votre console ou tableau de bord de supervision afin d’indiquer le décalage entre l’heure locale et l’heure serveur à chaque déploiement. Surveillez le taux d’échecs de validation temporelle comme indicateur de l’état opérationnel : une hausse de ce taux indique souvent une dérive de l’horloge plutôt que des problèmes réseau.
Les points de terminaison REST ont été lancés en premier le 16 novembre 2026. La prise en charge de WebSocket suivra le 19 novembre 2026. Les deux s’appliquent uniquement à l’architecture de trading Gate 3.0 ; les autres architectures ne prennent actuellement pas en charge cette fonctionnalité.
Chaque requête HTTP contient les deux en-têtes de manière indépendante. Le client calcule l’horodatage d’envoi au moment où il prépare la requête. Aucun état de connexion n’est à maintenir : chaque requête est autonome.
Avec WebSocket, la connexion est persistante. Le client envoie un message via une connexion établie. L’horodatage d’envoi doit refléter le moment où le message a été écrit dans le socket, et non celui où la connexion a été établie.
| Aspect | API REST | API WebSocket |
|---|---|---|
| Date de lancement | 16 novembre 2026 | 19 novembre 2026 |
| Modèle de connexion | Sans état (par requête) | Persistant (par connexion) |
| Moment de l’horodatage | Lors de la préparation de la requête | Lors de l’écriture du message dans le socket |
| Portée | Trading de contrats Gate 3.0 uniquement | Trading de contrats Gate 3.0 uniquement |
| Note d’intégration | Définir les deux en-têtes sur chaque requête | Calculer les horodatages par message, et non par connexion |
Le placement d’ordres et la gestion des abonnements via WebSocket bénéficient de la même capacité de vérification de l’heure : une demande d’abonnement obsolète ou un message d’ordre retardé est soumis à la même validation temporelle côté ME.
L’erreur d’intégration la plus fréquente consiste à envoyer un horodatage en millisecondes ou en secondes au lieu de microsecondes. Un horodatage en millisecondes est trois ordres de grandeur inférieur à un horodatage en microsecondes. Le serveur constatera un délai écoulé qui est en pratique négatif ou très ancien. Multipliez toujours par 1 000 000 lorsque vous partez de secondes, ou par 1 000 lorsque vous partez de millisecondes.
Si l’horloge de votre client est en avance ou en retard sur celle du serveur d’une durée supérieure à la fenêtre d’expiration, toutes les requêtes seront rejetées. La solution consiste à synchroniser l’horloge. Si vous ne pouvez pas utiliser NTP, calculez un décalage à partir du point de terminaison d’heure serveur de Gate et appliquez-le avant de générer l’horodatage d’envoi.
Une fenêtre de 100000 microsecondes (0,1 seconde) peut être trop restrictive pour des chemins réseau interrégionaux ou des clients dont la latence est variable. Si vous constatez des rejets fréquents avec une fenêtre restreinte, élargissez-la progressivement jusqu’à ce que le taux de rejet atteigne un niveau acceptable. Commencez avec 1000000 microsecondes (1 seconde) pour la plupart des stratégies.
Une fenêtre très large, par exemple 60000000 microsecondes ou 60 secondes, offre peu de protection contre les exécutions obsolètes. Dans un marché de contrats qui évolue rapidement, une requête vieille de 60 secondes sera presque certainement exécutée à un prix très éloigné du marché actuel. Adaptez la fenêtre à la tolérance réelle de latence de votre stratégie.
Si vous omettez l’un des deux en-têtes, l’API peut considérer que la requête ne comporte pas de validation temporelle. Le comportement dépend du point de terminaison et de sa configuration ; consultez la documentation officielle de l’API pour le point de terminaison spécifique que vous appelez. En règle générale, définissez toujours les deux en-têtes ensemble.
La validation temporelle des API Futures de Gate ajoute une capacité de vérification de l’heure côté moteur d’appariement (ME) des API de trading de contrats. Le client envoie X-Gate-Client-Send-Us (un horodatage en microsecondes indiquant le moment de préparation de la requête) et X-Gate-Timeout-Window-Us (la fenêtre de validité maximale en microsecondes). Cette mise à jour s’applique uniquement à l’architecture de trading Gate 3.0 et offre une protection contre les exécutions retardées par le réseau, la dérive de l’horloge et les requêtes rejouées.
L’intégration nécessite quatre étapes : synchroniser votre horloge, calculer l’horodatage d’envoi en microsecondes, définir les deux en-têtes pour chaque requête et mettre en œuvre une logique de nouvelle tentative qui recalcule l’horodatage. La prise en charge de REST a été lancée le 16 novembre 2026, et celle de WebSocket suivra le 19 novembre 2026, couvrant les interfaces de trading de contrats Gate 3.0.
La validation temporelle des API Futures de Gate est une capacité de vérification de l’heure ajoutée par Gate côté moteur d’appariement (ME) de ses API de trading de contrats. Deux en-têtes de requête, X-Gate-Client-Send-Us et X-Gate-Timeout-Window-Us, fonctionnent conjointement pour confirmer qu’une requête a été envoyée dans une fenêtre définie. La mise à jour s’applique uniquement à l’architecture de trading Gate 3.0.
Les prix sur le marché des contrats peuvent évoluer en quelques millisecondes. Un ordre retardé peut parvenir au moteur d’appariement bien après le moment prévu par le trader, entraînant des exécutions non souhaitées. La validation temporelle offre au client un moyen déclaratif d’indiquer « traiter cette requête comme non valide après N microsecondes », en assurant une protection contre les retards réseau, la dérive de l’horloge et les requêtes rejouées.
Les deux en-têtes sont conçus pour être utilisés conjointement. X-Gate-Client-Send-Us fournit l’horodatage d’envoi et X-Gate-Timeout-Window-Us fournit la fenêtre de validité. L’omission de l’un des deux signifie que le serveur ne peut pas effectuer la comparaison temporelle. Consultez la documentation officielle de l’API pour connaître les exigences spécifiques à chaque point de terminaison.
Le comportement par défaut lorsque X-Gate-Timeout-Window-Us est omis dépend de la configuration du point de terminaison. La documentation officielle de l’API Gate précise cette valeur par défaut. Les clients qui nécessitent un contrôle explicite doivent toujours définir l’en-tête plutôt que de s’appuyer sur la valeur par défaut.
Les deux en-têtes utilisent des microsecondes depuis l’époque Unix. Une seconde équivaut à 1000000 microsecondes. Une milliseconde équivaut à 1000 microsecondes.
L’API renvoie une erreur indiquant que la requête n’a pas satisfait la validation temporelle côté moteur d’appariement. Le code d’erreur exact et le format du message sont documentés dans la référence officielle des erreurs de l’API Gate. Les clients doivent gérer cette erreur en recalculant l’horodatage, puis en effectuant une nouvelle tentative.
Les clients existants qui n’envoient pas les nouveaux en-têtes continuent de fonctionner selon le comportement précédent. L’annonce officielle de Gate demande aux utilisateurs de l’API Gate 3.0 de vérifier et de mettre à jour leur logique d’intégration conformément aux derniers noms de champs afin de garantir le bon fonctionnement de la fonctionnalité de validation temporelle.
Le mécanisme s’applique uniquement aux API de trading de contrats (futures) de l’architecture de trading Gate 3.0. L’annonce officielle indique que les autres architectures ne prennent actuellement pas en charge cette fonctionnalité. Le trading au comptant, les wallets et les autres groupes d’API suivent des spécifications distinctes.
Avertissement : Le contenu ci-dessus est fourni uniquement à titre informatif et éducatif et ne constitue pas un conseil financier, d’investissement ou de trading. Le trading de futures et de produits dérivés comporte un risque important de perte. Consultez la documentation officielle de l’API Gate pour obtenir les spécifications les plus récentes des points de terminaison, des codes d’erreur et des exigences relatives aux champs.
* Les informations ne sont pas destinées à être et ne constituent pas des conseils financiers ou toute autre recommandation de toute sorte offerte ou approuvée par Gate.
* Cet article ne peut être reproduit, transmis ou copié sans faire référence à Gate. Toute contravention constitue une violation de la loi sur le droit d'auteur et peut faire l'objet d'une action en justice.





