Comment se connecter à l'API WebSocket de BitFinex?

L'API WebSocket de BitFinex permet le streaming et le trading de données en temps réel; Utilisez une clé API, un client WebSocket et des connaissances JSON pour connecter et gérer efficacement les abonnements.

Apr 14, 2025 at 05:56 am

Comprendre l'API WebSocket de BitFinex

L'API WebSocket de BitFinex est un outil puissant pour le streaming de données en temps réel et le trading sur l'échange BitFinex. Il permet aux développeurs de recevoir des données de marché, de passer des commandes et de gérer leurs comptes en temps réel. Pour utiliser efficacement cette API, il est essentiel de comprendre sa structure et ses capacités.

L'API WebSocket fonctionne sur un canal de communication persistant et duplex complet, ce qui signifie qu'une fois qu'une connexion est établie, les données peuvent être envoyées et reçues simultanément. Ceci est particulièrement utile pour les applications nécessitant des mises à jour de données à faible latence, telles que les robots de trading et les outils d'analyse du marché.

Prérequis pour se connecter à l'API WebSocket de BitFinex

Avant de pouvoir vous connecter à l'API WebSocket de BitFinex, il existe plusieurs conditions préalables que vous devez réaliser:

• Clé API et secret : vous devez générer une clé API et un secret à partir de votre compte BitFinex. Ceci est crucial pour l'authentification et l'accès aux données de votre compte.
• Client WebSocket : vous aurez besoin d'une bibliothèque client WebSocket compatible avec votre langage de programmation. Les choix populaires incluent ws pour Node.js, websocket-client pour Python et WebSocket++ pour C ++.
• Compréhension de JSON : L'API communique en utilisant JSON, donc une compréhension de base de JSON est nécessaire pour analyser et construire des messages.

Établir une connexion à l'API WebSocket de BitFinex

Pour vous connecter à l'API WebSocket de BitFinex, suivez ces étapes détaillées:

• Choisissez une bibliothèque WebSocket : sélectionnez une bibliothèque WebSocket qui convient à votre environnement de développement. Pour cet exemple, nous utiliserons la bibliothèque websocket-client de Python.

• Installez la bibliothèque : installez la bibliothèque à l'aide de PIP:

   pip install websocket-client

• Importez la bibliothèque : dans votre script Python, importez le module nécessaire:

   import websocket

• Définissez l'URL WebSocket : L'URL de l'API WebSocket de BitFinex est wss://api-pub.bitfinex.com/ws/2 . Utilisez cette URL pour établir une connexion:

   ws = websocket.WebSocket()
   ws.connect('wss://api-pub.bitfinex.com/ws/2')

• Envoyer une demande d'authentification : si vous avez besoin d'un accès authentifié, vous devez envoyer une demande d'authentification. Construisez le message d'authentification à l'aide de votre clé API et secret:

   import json
   import hmac
   import hashlib
   import time api_key = 'your_api_key'
   api_secret = 'your_api_secret'
  
  
  
  nonce = str (int (time.time () * 1000))
   auth_payload = 'auth' + nonce
   signature = hmac.new (api_secret.encode (), auth_payload.encode (), hashlib.sha384) .hexdigest ()
  
  
  auth_msg = {
  
  
  'event': 'auth', 'apiKey': api_key, 'authSig': signature, 'authPayload': auth_payload, 'authNonce': nonce
   }
   
  ws.Send (json.dumps (auth_msg))

• Abonnez-vous aux canaux : une fois connectés, vous pouvez vous abonner à divers canaux pour recevoir des données en temps réel. Par exemple, pour vous abonner au bricker BTC / USD:

   subscribe_msg = { 'event': 'subscribe', 'channel': 'ticker', 'symbol': 'tBTCUSD'

  }

  ws.Send (JSON.Dumps (abonnez-vous)))

• Recevoir et traiter les données : utilisez une boucle pour recevoir et traiter en continu les données entrantes:

   while True: result = ws.recv() if result: print(json.loads(result))

Gestion des événements et messages WebSocket

Lorsque vous êtes connecté à l'API WebSocket de BitFinex, vous recevrez différents types de messages. Il est important de gérer ces messages de manière appropriée:

• Confirmation d'abonnement : Lorsque vous vous abonnez à un canal, vous recevrez un message de confirmation. Ce message aura un champ event avec la valeur subscribed .

• Messages de données : ces messages contiennent les données réelles auxquelles vous vous êtes souscrit. Par exemple, les données de ticker incluront des champs comme bid , ask , last_price , etc.

• Messages d'erreur : s'il existe une erreur, comme une défaillance d'authentification ou un abonnement non valide, vous recevrez un message d'erreur. Ces messages auront un champ event avec l' error de valeur.

Pour gérer ces messages, vous pouvez utiliser des instructions conditionnelles pour analyser le JSON entrant et agir en conséquence. Par exemple:

 import json

Def on_Message (WS, message):

 data = json.loads(message) if data.get('event') == 'subscribed': print(f'Subscribed to {data['channel']}') elif data.get('event') == 'error': print(f'Error: {data['msg']}') else: print(f'Received data: {data}')

ws = Websocket.websocketApp ('wss: //api-pub.bitfinex.com/ws/2', on_message = on_message)
wsrun_forever ()

Gérer la connexion et le traitement des erreurs

La maintenance d'une connexion stable à l'API WebSocket de BitFinex nécessite une gestion robuste des erreurs et une logique de reconnexion. Voici quelques stratégies pour gérer efficacement les connexions:

• Reconnexion : implémentez un mécanisme à reconnecter si la connexion est perdue. Vous pouvez utiliser une boucle qui tente de vous reconnecter à intervalles réguliers:

   while True: try: ws = websocket.WebSocket() ws.connect('wss://api-pub.bitfinex.com/ws/2') break except Exception as e: print(f'Connection failed. Retrying in 5 seconds: {e}') time.sleep(5)

• Heartbeat : L'API WebSocket de BitFinex envoie un message de battement de cœur toutes les 15 secondes. Vous pouvez l'utiliser pour surveiller la santé de la connexion:

   def on_ping(ws, message): print('Received ping')

  ws = Websocket.websocketApp ('wss: //api-pub.bitfinex.com/ws/2', on_ping = on_ping)
  wsrun_forever ()

• Gestion des erreurs : implémentez la gestion des erreurs pour attraper et répondre à divers types d'erreurs, telles que les problèmes de réseau ou les erreurs spécifiques à l'API:

   def on_error(ws, error): print(f'Error occurred: {error}')

  ws = Websocket.websocketApp ('wss: //api-pub.bitfinex.com/ws/2', on_error = on_error)
  wsrun_forever ()

Souscript à plusieurs canaux et traitement des données

Pour tirer le meilleur parti de l'API WebSocket de BitFinex, vous pouvez vous abonner simultanément à plusieurs canaux. Cela vous permet de recevoir différents types de données en temps réel, tels que les tickers, les métiers et les livres de commandes.

Voici un exemple de la façon de s'abonner à plusieurs canaux:

 import json ws = Websocket.websocket ()
 ws.connect ('wss: //api-pub.bitfinex.com/ws/2')



canaux = [


{'channel': 'ticker', 'symbol': 'tBTCUSD'}, {'channel': 'trades', 'symbol': 'tBTCUSD'}, {'channel': 'book', 'symbol': 'tBTCUSD', 'prec': 'P0', 'freq': 'F0', 'len': '25'}
 ]]
 
Pour le canal dans les canaux:
 
subscribe_msg = { 'event': 'subscribe', **channel } ws.send(json.dumps(subscribe_msg))
 Bien que vrai:
 
result = ws.recv() if result: print(json.loads(result))
 Chaque canal enverra des données dans un format spécifique, vous devez donc gérer ces messages en conséquence. Par exemple, les données de ticker auront des champs différents par rapport aux données commerciales.
 
Questions fréquemment posées
 Q: Puis-je utiliser l'API WebSocket de BitFinex pour le trading automatisé?
 
R: Oui, l'API WebSocket de BitFinex prend en charge le trading automatisé. Vous pouvez l'utiliser pour passer des commandes, gérer votre compte et recevoir des données de marché en temps réel, ce qui est essentiel pour construire des robots de trading.
 
Q: Y a-t-il une limite au nombre de canaux auxquels je peux souscrire?
 
R: BitFinex ne spécifie pas une limite dure au nombre de canaux auxquels vous pouvez vous abonner, mais il est important de gérer efficacement vos abonnements pour éviter l'écrasement de votre application avec des données.
 
Q: Comment puis-je assurer la sécurité de ma clé API et de mon secret lors de l'utilisation de l'API WebSocket?
 
R: Pour assurer la sécurité de votre clé API et de votre secret, ne les partagez jamais publiquement, utilisez-les uniquement sur des réseaux sécurisés et envisagez d'utiliser des variables d'environnement ou un coffre-fort sécurisé pour les stocker dans votre application.
 
Q: Que dois-je faire si je rencontre une erreur de limite de taux?
 
R: Si vous rencontrez une erreur de limite de taux, vous devez implémenter une stratégie de revers dans votre application. Cela implique de ralentir vos demandes et de réessayer après une certaine période pour se conformer aux limites de taux de BitFinex.