Comment créer un robot de trading Bybit : guide technique du développeur

Présentation de l'architecture de l'API Bybit

1. Les API REST et WebSocket de Bybit fonctionnent selon un cadre strict de limitation de débit dans lequel chaque point de terminaison appartient à un niveau de pondération spécifique : les points de terminaison publics tels que les requêtes de ticker et de carnet d'ordres consomment 1 unité par appel, tandis que les points de terminaison privés tels que le placement de commandes ou la modification de position portent des poids allant de 3 à 10 unités en fonction de la complexité de la charge utile.

2. L'authentification repose sur les signatures HMAC-SHA256 générées à l'aide de la clé secrète, de l'horodatage et de la chaîne de requête canonique ; toute inadéquation dans l'alignement des noms occasionnels ou dans la fenêtre d'expiration de la signature (maximum 30 secondes) déclenche des réponses immédiates 401 non autorisées.

3. L'API v5 introduit la prise en charge du mode marge unifié sur les marchés au comptant, perpétuel inversé, perpétuel linéaire et d'options. Cela nécessite une spécification explicite du paramètre de catégorie dans chaque en-tête de requête pour éviter les erreurs de routage ambiguës.

4. Les connexions WebSocket doivent être établies avec une négociation d'authentification obligatoire avant de s'abonner à des canaux privés ; l'échec de l'envoi du paquet d'authentification dans les 10 secondes suivant la connexion entraîne une résiliation forcée.

5. Les événements du cycle de vie des commandes, notamment la création, l'exécution partielle, l'exécution complète, l'annulation et le rejet, sont émis via des flux distincts sous des sujets distincts tels que l'ordre, l'exécution et la position, nécessitant une gestion indépendante des abonnements par sujet.

Composants d'intégration de base

1. Le connecteur ccxt.bybit gère l'adaptation automatique de la limite de débit en analysant les en-têtes X-RateLimit-Remaining et en limitant dynamiquement les requêtes ultérieures lorsque les seuils descendent en dessous de 20 % du quota alloué.

2. La logique de commutation du mode marge réside dans le module Exchange_instance_service.ts , qui applique des transitions d'état atomiques entre les configurations isolées et à marge croisée sans exposer les appels d'API bruts aux utilisateurs finaux.

3. Des instantanés de la profondeur du carnet de commandes sont récupérés via le flux WebSocket orderBookL2_25 , fournissant des niveaux d'offre/vente triés par prix avec des horodatages de précision à la microseconde intégrés dans chaque charge utile de mise à jour.

4. La synchronisation des positions utilise une réconciliation basée sur delta : le bot compare les sommes de contrôle du cache local aux numéros de version de position côté serveur renvoyés dans chaque événement de mise à jour de position pour détecter et résoudre les incohérences sans rechargement complet de l'état.

5. La validation de l'exécution des transactions s'effectue à trois niveaux : vérification des paramètres avant la soumission, vérification du code d'état après la réponse et confirmation après le remplissage via la corrélation du flux d'exécution, garantissant qu'aucun ordre non confirmé ne persiste dans des états ambigus.

Mécanismes d’exécution de la stratégie

1. Une stratégie de suivi des tendances basée sur les contrats perpétuels linéaires de Bybit calcule les valeurs EMA(9) et EMA(21) directement à partir des données de bougie récupérées via GET /v5/market/candles , avec une résolution d'intervalle configurable jusqu'à 1 minute.

2. Les niveaux de stop-loss et de take-profit sont soumis de manière atomique aux côtés des ordres d'entrée à l'aide du paramètre tpSlMode défini sur Partial, permettant un ajustement dynamique des stop suiveurs sur la base des calculs ATR(14) en temps réel.

3. La logique d'arbitrage du taux de financement surveille simultanément les points finaux GET /v5/market/funding/history sur plusieurs symboles, déclenchant des positions de couverture uniquement lorsque le différentiel de financement absolu dépasse 0,025 % sur trois intervalles consécutifs.

4. L'évaluation du risque de liquidation intègre des mises à jour en temps réel des capitaux propres du compte à partir du flux walletBalance avec les valeurs notionnelles des positions ouvertes pour calculer le ratio de marge toutes les 200 millisecondes.

5. L'exécution du prix moyen pondéré dans le temps (TWAP) divise les ordres importants en ordres enfants de taille fixe espacés à des intervalles configurables, le prix de chaque ordre enfant étant dérivé du prix moyen actuel plus un tampon de glissement calculé à partir de la profondeur du carnet d'ordres des 5 dernières secondes.

Protocoles de gestion des erreurs et de récupération

1. La détection des déconnexions du réseau utilise une surveillance à double couche : des délais d'expiration TCP au niveau du système d'exploitation combinés à une validation du rythme cardiaque ping/pong au niveau de l'application toutes les 15 secondes sur toutes les connexions WebSocket actives.

2. Les échecs de soumission de commandes déclenchent des séquences de tentatives d'attente exponentielles limitées à cinq tentatives, avec une instabilité appliquée pour empêcher les tentatives synchronisées entre les instances de robots distribuées.

3. Les erreurs de signature non valides déclenchent un flux de réauthentification immédiat, supprimant les informations d'identification mises en cache et forçant la régénération de nouvelles clés API si les échecs répétés dépassent trois dans une fenêtre de 60 secondes.

4. La désynchronisation du carnet de commandes est corrigée en demandant un instantané complet via REST GET /v5/market/orderbook suivi d'un correctif delta incrémentiel à partir des mises à jour WebSocket ultérieures.

5. La récupération des incompatibilités de position appelle une réinitialisation forcée de la position via POST /v5/position/reset-isolated pour les comptes sur marge isolés ou POST /v5/position/set-leverage pour les scénarios de marges croisées afin de restaurer un alignement d'état cohérent.

Normes de configuration de sécurité

1. Les autorisations des clés API sont appliquées au niveau de la bourse : les clés de trading doivent avoir la gestion des ordres et la gestion des positions activées, tandis que les clés en lecture seule nécessitent uniquement un accès aux informations de compte .

2. La liste blanche IP est obligatoire pour les déploiements de production : toute demande provenant de l'extérieur des plages CIDR pré-approuvées reçoit une réponse immédiate 403 Forbidden, quelle que soit la signature valide.

3. Les clés secrètes sont stockées cryptées à l'aide d'AES-256-GCM avec des clés éphémères par processus alternées toutes les 24 heures, empêchant ainsi une exposition à long terme même si les vidages de mémoire sont compromis.

4. Toutes les requêtes HTTP sortantes incluent l'en-tête X-BAPI-RECV-WINDOW défini sur 5 000 millisecondes, rejetant toute réponse du serveur retardée au-delà de ce seuil afin d'atténuer les vecteurs d'attaque par réexécution.

5. Les jetons de contournement d'authentification à deux facteurs ne sont jamais conservés localement : ils sont générés à la demande lors de la configuration initiale et supprimés immédiatement après un enregistrement réussi de l'API.

Foire aux questions

Q1 : Puis-je utiliser la même clé API pour le trading au comptant et sur produits dérivés sur Bybit ? Oui, mais la clé doit recevoir explicitement des autorisations pour les deux catégories lors de la création ; tenter d'accéder aux points de terminaison des dérivés avec une clé ponctuelle uniquement renvoie le code d'erreur 10003.

Q2 : Comment Bybit gère-t-il les identifiants d'ordres en double sur différentes paires de trading ? Chaque ID d'ordre est limité à son symbole : des ID d'ordre client identiques peuvent exister simultanément sur BTCUSDT et ETHUSDT sans conflit, mais la détection de collision s'applique strictement dans le même contexte de paire de négociation.

Q3 : Que se passe-t-il si mon bot soumet une commande avec des paramètres d'effet de levier non valides ? L'API le rejette avec le code d'erreur 30083 et inclut la plage de levier exacte autorisée dans le corps de la réponse, permettant une correction immédiate sans intervention manuelle.

Q4 : Existe-t-il un moyen de déterminer par programmation la liquidité actuelle du marché avant de passer des commandes importantes ? Oui, le point de terminaison GET /v5/market/tickers renvoie les champs bidSize et AskSize indiquant le volume de liquidité en haut du livre, tandis que GET /v5/market/orderbook fournit une profondeur cumulée à des niveaux de prix spécifiés.