BitFinex API Trading: le guide ultime pour les développeurs.

Comprendre les bases de l'API BitFinex

1. BitFinex fournit une API de repos et WebSocket complète qui permet aux développeurs d'interagir avec son moteur de trading, ses données de compte et ses informations de marché. L'API prend en charge les points de terminaison publics et privés, permettant l'accès aux données de ticker en temps réel, aux livres de commandes, aux métiers historiques et aux soldes de portefeuille personnels. Pour commencer, les développeurs doivent générer des clés API à partir de leur compte BitFinex avec des autorisations appropriées telles que la lecture, la mise en place de commandes ou le retrait de fonds.

2. L'API REST est idéale pour les demandes uniques telles que la récupération des informations de compte ou la mise en place d'une seule commande. Il fonctionne sur HTTPS et renvoie des données au format JSON. Chaque demande privée doit être authentifiée à l'aide d'une clé API, d'une clé secrète et d'un jeton Web JSON (JWT) généré avec le cryptage HMAC-SHA384. Le processus d'authentification garantit un accès sécurisé aux données et aux capacités de transaction spécifiques à l'utilisateur.

3. L'API WebSocket est préférée pour le streaming de données en temps réel, y compris les mises à jour de prix en direct, les rapports d'exécution des commandes et les modifications de position. Il maintient une connexion persistante, réduisant la latence et permettant des stratégies de négociation à haute fréquence. Les développeurs peuvent s'abonner à divers canaux tels que Ticker, Book, Raw Book et Cougies pour recevoir des flux de données continus.

4. Les limites de taux sont appliquées pour maintenir la stabilité du système. Les points de terminaison publics permettent jusqu'à 90 demandes par minute, tandis que les points de terminaison privés sont limités à 50 demandes par minute. Le dépassement de ces limites peut entraîner un blocage temporaire IP. La mise en œuvre des mécanismes de revers exponentielle et de mise en file d'attente peut aider à gérer efficacement les contraintes de taux.

5. BitFinex prend en charge plusieurs paires de trading, y compris les crypto-monnaies majeures comme BTC, ETH et stablecoins tels que l'USDT. Chaque paire a des niveaux de précision spécifiques pour le prix et le montant, qui doivent être respectés lors de la construction de commandes. Les développeurs doivent récupérer les détails du symbole via le point de terminaison / symboles pour assurer la mise en forme correcte.

Configuration de votre environnement de développement

1. Choisissez un langage de programmation qui prend en charge les demandes HTTP et les connexions WebSocket. Les options populaires incluent Python, JavaScript (Node.js) et GO. Des bibliothèques telles que Axios, WebSocket-node ou CCXT simplifient l'intégration de l'API en gérant l'authentification et la mise en forme des messages.

2. Installez les dépendances nécessaires à l'aide de gestionnaires de packages comme PIP, NPM ou GO MOD. Par exemple, dans Python, installez les demandes et les bibliothèques WebSocket-Client pour gérer REST et WebSocket Communications. Utilisez des environnements virtuels pour isoler les dépendances du projet et éviter les conflits.

3. Stockez les informations d'identification de l'API en toute sécurité à l'aide de variables d'environnement ou un fichier de configuration en dehors du contrôle de version. Jamais les touches Hardcode dans les fichiers source. Utilisez des outils comme DOTENV pour gérer les données sensibles pendant le développement.

4. Testez la connectivité de l'API en faisant une demande publique simple, comme la récupération du ticker actuel pour BTC / USD. Une réponse réussie confirme l'accès au réseau et les URL de point de terminaison correctes. Utilisez des environnements de bac à sable si disponibles pour éviter les métiers en direct involontaires lors des tests.

5. Implémentez la journalisation pour surveiller les demandes et les réponses de l'API. Loguez les horodatages, les appels de terminaux et les messages d'erreur pour diagnostiquer rapidement les problèmes. Faites tourner les bûches régulièrement pour éviter une utilisation excessive du disque, en particulier dans les robots commerciaux de longue date.

Exécuter les métiers et gérer les commandes

1. Placez le marché, la limite, l'arrêt et les commandes d'arrêt de fin utilisant le point de terminaison de la soumission des commandes V2. Chaque ordre nécessite des paramètres tels que le symbole (par exemple, TBTCUSD), le montant (positif pour l'achat, négatif pour la vente) et le type (par exemple, la limite d'échange). Assurez-vous que la précision du montant correspond à la configuration du symbole pour éviter le rejet.

2. Surveillez l'état de la commande via des notifications WebSocket ou un sondage de repos périodique. L'API émet des mises à jour d'exécution, y compris les remplissages partiels, l'exécution complète ou l'annulation. L'abonnement à la chaîne «Orders» offre des mises à jour en temps réel, cruciales pour les stratégies algorithmiques.

3. Annuler les commandes individuellement ou en vrac à l'aide de la commande Annuler le point de terminaison. Fournissez l'ID de commande pour l'annulation unique ou utilisez des filtres comme le symbole et le côté pour l'annulation de masse. Vérifiez toujours la confirmation d'annulation avant de supposer que la commande est supprimée.

4. Gérer les remplissages partiels en ajustant la logique de suivi de la position. Certaines commandes s'exécutent dans plusieurs transactions, nécessitant une agrégation pour déterminer le prix de remplissage moyen et la quantité restante. Maintenez un miroir de carnet de commandes local pour se synchroniser avec BitFinex State.

5. Implémentez la gestion des erreurs pour les problèmes communs tels que les fonds insuffisants, les paramètres non valides ou les délais d'attente de réseau. Les codes d'erreur d'analyse comme 10300 (clé introuvable) ou 10001 (ordre non valide) pour déclencher des actions correctives. Réessayez les échecs transitoires avec les retards pour éviter les erreurs en cascade.

Questions fréquemment posées

Comment générer une signature API valide pour les demandes privées? Utilisez HMAC-SHA384 pour signer une charge utile concaténée composée du chemin de demande, du nonce et du corps (le cas échéant) avec votre clé secrète. Encoder le résultat dans la base64 et l'inclure dans l'en-tête «x-bfx-signature». Le nonce doit être un entier strictement croissant pour éviter les attaques de relecture.

Quelle est la différence entre le livre brut et le livre L2 dans WebSocket Feeds? Le livre brut (livre / R0) montre chaque ordre individuel dans le livre de commandes, offrant une profondeur de marché complète. Le L2 Book (Book / P0) regroupe les commandes par niveau de prix, réduisant le volume de données. Utilisez le livre brut pour les stratégies de scalping nécessitant une précision et L2 pour la surveillance générale du marché.

Puis-je échanger des positions à terme et de marge en utilisant l'API BitFinex? Oui, l'API prend en charge le trading et les dérivés de marge. Utilisez des symboles préfixés avec «F» pour les contrats à terme (par exemple, fbtcf0) et «t» avec des suffixes de marge pour les positions à effet de levier. Assurez-vous que votre compte a une marge suffisante et que votre clé API a des autorisations de trading activées.

À quelle fréquence BitFinex met à jour les données de chandelles via WebSocket? Les mises à jour des bougies sont publiées à la fin de chaque intervalle. Les délais pris en charge comprennent 1M, 5M, 15M, 30M, 1H, 3H, 6H et 1D. Le flux WebSocket émet une nouvelle bougie une fois la période clôturée, contenant des valeurs ouvertes, élevées, faibles, fermées et volumiques.