Comment utiliser l'API Bybit pour le trading de contrats?

L'API Bybit permet le trading de contrats automatisé avec une authentification sécurisée, des données en temps réel via WebSocket et une gestion des commandes complètes pour les contrats USDT et inverses.

Aug 11, 2025 at 01:01 pm

Comprendre l'API Bybit pour le trading contractuel

L' API Bybit est un outil puissant qui permet aux traders d'automatiser leurs stratégies de négociation de contrat sur l'échange de Bybit. En tirant parti de l'API, les utilisateurs peuvent passer par programme des commandes, gérer les positions, récupérer les données du marché et surveiller l'état du compte. Pour commencer, il est essentiel de comprendre que Bybit prend en charge l'API RESTful et l'API WebSocket pour une interaction en temps réel. Les points de terminaison API pour le trading de contrats sont spécifiquement adaptés à des contrats USDT perpétuels, perpétuels inverses et à terme . Avant toute intégration, assurez-vous d'accéder à la documentation API correcte en fonction du type de contrat que vous avez l'intention de négocier.

Pour commencer, accédez à vos paramètres de compte Bybit et générez des clés API. Au cours de ce processus, vous devez définir des autorisations telles que «l'ordre», «actif» et «lecture seule». Pour le trading de contrats, des autorisations «ordonnance» et «position» sont nécessaires. N'exposez jamais votre clé secrète dans le code côté client ou les référentiels publics. Utilisez toujours HTTPS lors de la création d'appels API pour assurer une communication sécurisée.

Configuration de vos informations d'identification API

Pour utiliser efficacement l'API Bybit, vous devez d'abord créer et configurer vos clés API. Connectez-vous à votre compte Bybit et accédez à la section de gestion des API dans votre profil. Cliquez sur Créer API , puis attribuez un nom à votre clé pour une identification facile. Lors de la définition des autorisations:

• Activer l'autorisation du commerce pour autoriser le placement des commandes et l'annulation
• Activer l'autorisation de position pour accéder aux positions ouvertes et à tirer parti des paramètres
• Restreindre le retrait sauf si vous avez absolument nécessaire pour réduire les risques de sécurité

Après la création, vous recevrez trois composants critiques: clé API , clé secrète et ID utilisateur . Les stocker en toute sécurité. Vous pouvez également définir des restrictions IP pour limiter l'accès à l'API à des adresses IP spécifiques, en améliorant la sécurité. Si votre IP change, vous devez mettre à jour la liste blanche en conséquence. Notez que Bybit utilise HMAC-SHA256 pour l'authentification, donc vos demandes doivent inclure un message correctement signé.

Authentification des demandes d'API

Chaque demande d'API privée à revoir doit être authentifiée à l'aide de votre clé API et de votre clé secrète . Le processus d'authentification consiste à générer une signature en utilisant le hachage HMAC-SHA256. La chaîne à signer comprend généralement la méthode HTTP, le chemin de la demande, les paramètres de requête et l'horodatage. L' horodatage doit être dans les 5 secondes suivant l'heure du serveur pour éviter les attaques de relecture.

Voici comment construire la signature:

• COMPATENER LA MÉTHODE DE LA REQUÊTE (par exemple, POST), le chemin de demande (par exemple, / v5 / ordre / création) et la chaîne de requête (le cas échéant)
• Utilisez votre clé secrète pour hacher la chaîne concaténée à l'aide de HMAC-Sha256
• Coder le résultat au format hexadécimal
• Incluez la signature dans l'en-tête de demande comme X-BAPI-SIGN

Les en-têtes supplémentaires requis incluent X-BAPI-API-KEY , X-BAPI-TIMESTAMP et X-BAPI-RECV-WINDOW (facultatif, 5000 ms par défaut). L'horodatage ou la signature incorrect entraînera une défaillance d'authentification. Vérifiez toujours que votre horloge système est synchronisée avec les serveurs NTP.

Placer et gérer les ordres contractuels

Pour passer une commande contractuelle via l'API Bybit, utilisez / V5 / Order / Create Endpoint. Vous devez inclure des paramètres essentiels tels que le symbole , le côté (acheter ou la vente), le type de commande (limite, le marché, etc.), la qté et le prix (pour les commandes de limite). Pour les contrats à marge USDT , le format de symbole est BTCUSDT . Pour les contrats inverses , c'est BTCUSD .

Paramètres clés à considérer:

• TimeInforce : les options incluent GoodTillCancel, immédiatorcancel, Fillorkill
• Réduisez-vous : réglé sur True pour s'assurer que la commande réduit la taille de la position uniquement
• CloseRrigger : utile pour les commandes stop-loss ou à but lucratif
• PositionIDX : requis pour le mode de couverture; 0 pour un sens unique, 1 pour long, 2 pour court

Pour annuler une commande, utilisez le point de terminaison / V5 / Order / Annuler avec l' OrderId ou OrderLinkId . Pour récupérer les commandes actives, utilisez / v5 / commande / en temps réel . Pour la gestion de la position, le point de terminaison / v5 / position / liste renvoie les positions actuelles, y compris la taille , le prix d'entrée et l'effet de levier . Ajustez l'effet de levier à l'aide / v5 / position / set-le-le-liset .

Récupération des données du marché et des comptes

Les données du marché en temps réel sont cruciales pour les décisions de négociation éclairées. Bybit fournit plusieurs points de terminaison publics à cet effet. Utiliser / V5 / Market / Tickers pour obtenir les derniers prix, les taux de financement et le volume 24h / 24 pour tous les contrats. Pour les données de carnet de commandes, utilisez / V5 / Market / Orderbook avec les paramètres de symbole et de profondeur (par exemple, 1, 5, 50 niveaux). Pour récupérer les données historiques des chandeliers, utilisez / V5 / Market / Kline avec catégorie , symbole , intervalle et heure de début / fin .

Pour les données liées au compte, le point de terminaison de l'élevage / v5 / compte / portefeuille renvoie votre solde de portefeuille sur toutes les pièces. Utiliser / V5 / Compte / Info pour obtenir les détails globaux du compte, y compris les capitaux propres totaux et le solde disponible. Pour surveiller les commandes récentes, utilisez / V5 / Ordre / Liste d'exécution . Cela renvoie les transactions exécutées avec le prix , le montant , les frais et l'exemple .

Implémentation de WebSocket pour les mises à jour en temps réel

Pour le trading à faible latence, utilisez l'API WebSocket de Bybit au lieu de sonder les points de terminaison de repos. Connectez-vous à wss://stream.bybit.com/v5/public/linear pour les contrats USDT ou wss://stream.bybit.com/v5/public/inverse pour les contrats inverses. Pour vous abonner à des données en temps réel, envoyez un message JSON avec le champ OP défini sur «vous abonner» et le tableau Args contenant des sujets comme orderBookL2_25.BTCUSDT , tickers.BTCUSDT , ou candle.1.BTCUSDT .

Pour les données privées telles que les mises à jour de commande et les modifications de position, authentifiez la connexion WebSocket. Envoyez une demande d'authentification avec votre clé API , votre horodatage et votre signature . Une fois authentifié, abonnez-vous aux sujets order , position et execution pour recevoir des mises à jour en direct. Les messages WebSocket sont compressés à l'aide de ZLIB , alors décompressez-les avant l'analyse.

Questions fréquemment posées

Quelle est la limite de taux pour l'API BUBIT?

Le recours applique des limites de taux pour prévenir les abus. Pour l'API REST, la limite est généralement de 60 demandes par seconde par touche API. Dépassant ceci se traduit par des erreurs HTTP 429. Les connexions WebSocket permettent un débit plus élevé mais sont également soumis à des limites en fonction du nombre d'abonnement et de la fréquence des messages.

Comment gérer les erreurs d'API comme la «signature non valide»?

Assurez-vous que votre clé secrète est correcte et non taillée. Vérifiez que la chaîne de signature inclut la méthode exacte, le chemin et les paramètres. Vérifiez que l' horodatage est en millisecondes et dans les 5 secondes suivant l'heure du serveur de Bybit. Utilisez https://api.bybit.com/v5/market/time pour récupérer l'heure actuelle du serveur.

Puis-je utiliser l'API Bybit pour le trading de grille ou les bots DCA?

Oui, l'API prend en charge les stratégies automatisées. Utiliser / V5 / Order / Créer dans une boucle avec des prix et des quantités variables. Implémentez la logique pour annuler les commandes périmées et ajuster les positions en fonction des conditions du marché. Assurez-vous que votre bot gère les paiements de taux de financement et les risques de liquidation .

TestNet est-il disponible pour le trading des contrats API?

Oui, Bybit propose un environnement testnet sur https://api-testnet.bybit.com . Utilisez-le pour simuler les métiers sans risquer de vrais fonds. Générez des touches API distinctes pour TestNet. Tous les points de terminaison reflètent l'environnement en direct, permettant des tests de stratégie complets.