Comment utiliser l'API REST de BitFinex?

L'API REST de BitFinex vous permet d'échanger, d'obtenir des données de marché et de gérer votre compte par programme; Ce guide fournit des étapes et des exemples pour une utilisation efficace.

Apr 14, 2025 at 03:35 am

L'utilisation de l'API REST de BitFinex vous permet d'interagir par programme avec l'échange, vous permettant d'effectuer des tâches telles que le trading, la récupération des données du marché et la gestion de votre compte. Ce guide vous guidera à travers les étapes essentielles et fournira des instructions détaillées sur la façon d'utiliser efficacement l'API REST de BitFinex.

Début avec l'API REST de BitFinex

Avant de pouvoir commencer à utiliser l'API REST de BitFinex, vous devez configurer une clé API. Pour ce faire, suivez ces étapes :

• Connectez-vous à votre compte BitFinex.
• Accédez à la section «compte» et sélectionnez «API».
• Cliquez sur «Nouvelle clé» pour générer une nouvelle clé API.
• Choisissez les autorisations que vous souhaitez accorder à la clé, telles que le trading, les retraits ou l'accès en lecture seule.
• Confirmez la création de la clé et stockez en toute sécurité la clé API et le secret.

Une fois que vous avez votre clé API et votre secret, vous pouvez commencer à faire des demandes à l'API BitFinex REST. L'API utilise HTTPS et prend en charge JSON pour l'échange de données.

Authentification et sécurité

L'authentification est cruciale pour sécuriser vos interactions API . BitFinex utilise une combinaison de votre clé API et une signature générée à l'aide de votre secret API. Voici comment authentifier vos demandes:

• Générer un nonce : un numéro unique qui garantit que chaque demande est unique. Il peut s'agir d'un horodatage ou d'un entier incréments.
• Créez une charge utile : combinez le chemin API, le nonce et tout paramètre supplémentaire dans un objet JSON.
• Générez la signature : utilisez l'algorithme HMAC-SHA384 avec votre secret API pour signer la charge utile.
• Incluez les en-têtes : ajoutez la clé API, la charge utile et la signature à vos en-têtes de demande.

Voici un exemple de la façon de créer les en-têtes nécessaires dans Python:

 import time
 import json
 import hmac
 import hashlib api_key = 'your_api_key'
 api_secret = 'your_api_secret'.encode ()



Générer nonce
 nonce = str (int (time.time () * 1000))


Créer une charge utile
 charge utile = {


'request': '/v1/balance', 'nonce': nonce
 }
 
Convertir la charge utile en JSON et encoder
 upload_json = json.dumps (charge utile) .encode ()
 
Générer une signature
 signature = hmac.new (api_secret, Payload_json, hashlib.sha384) .hexdigest ()
 
Préparer les en-têtes
 en-têtes = {
 
'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature
 }

Faire des demandes d'API

Avec l'authentification en place, vous pouvez désormais faire des demandes à l'API REST de BitFinex. Voici quelques points de terminaison courants et comment les utiliser :

• Récupérer les soldes du compte : utilisez le point de terminaison /v1/balances pour vérifier les soldes de votre compte.

 import requests url = 'https://api.bitfinex.com/v1/balances'
 Response = requers.get (URL, en-têtes = en-têtes)
 imprimer (réponse.json ())

• Passez une commande : utilisez le point de terminaison /v1/order/new pour passer une nouvelle commande. Vous devez spécifier le symbole, le montant, le prix et le type de commande.

 payload = { 'request': '/v1/order/new', 'nonce': nonce, 'symbol': 'btcusd', 'amount': '0.01', 'price': '10000', 'exchange': 'bitfinex', 'type': 'exchange limit', 'side': 'buy'

}

upload_json = json.dumps (charge utile) .encode ()
signature = hmac.new (api_secret, Payload_json, hashlib.sha384) .hexdigest ()

en-têtes = {

'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature

}

url = 'https://api.bitfinex.com/v1/order/new'
Response = requêtes.Post (URL, en-têtes = en-têtes)
imprimer (réponse.json ())

• Récupérer les données du marché : utilisez le point de terminaison /v1/pubticker pour obtenir le ticker actuel pour une paire de trading spécifique.

 url = 'https://api.bitfinex.com/v1/pubticker/btcusd'
 response = requests.get(url)
 print(response.json())

Gestion des erreurs et des réponses

Lorsque vous utilisez l'API BitFinex REST, il est important de gérer les erreurs et d'interpréter correctement les réponses. Voici quelques conseils :

• Vérifiez le code d'état HTTP : un code d'état 200 indique une demande réussie, tandis que d'autres codes indiquent les erreurs.
• Analyser la réponse JSON : la réponse contiendra un objet JSON avec les données ou les messages d'erreur demandés.
• Codes d'erreur courantes : Familiarisez-vous avec les codes d'erreur communs comme 400 (mauvaise demande), 401 (non autorisé) et 500 (erreur du serveur interne).

Voici un exemple de la façon de gérer les erreurs dans Python:

 import requests url = 'https://api.bitfinex.com/v1/balances'
 Response = requers.get (URL, en-têtes = en-têtes)



Si réponse.status_code == 200:


print('Request successful:', response.json())
 autre:
 
print('Error:', response.status_code, response.text)
 Utilisation de WebSockets pour des données en temps réel
 Alors que l'API REST convient à de nombreuses tâches, l'utilisation de WebSockets peut fournir des mises à jour de données en temps réel. Pour se connecter à l'API WebSocket de BitFinex, suivez ces étapes :
 
Établir une connexion WebSocket : utilisez une bibliothèque WebSocket comme websocket-client dans Python.
 import websocket
 ws = Websocket.websocket ()
 ws.connect ('wss: //api-pub.bitfinex.com/ws/2')

• Abonnez-vous aux canaux : Envoyez un message JSON pour vous abonner à des canaux spécifiques, tels que les mises à jour de billeur ou de carnet de commandes.

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

}

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

• Traiter les messages entrants : analyser les messages JSON entrants pour gérer les données en temps réel.

 result = ws.recv()
 print(result)

Gestion des limites de taux d'API

BitFinex impose les limites de taux aux demandes d'API pour prévenir les abus. Pour gérer efficacement ces limites :

• Comprendre les limites : BitFinex a des limites de taux différentes pour les demandes authentifiées et non authentifiées. Les demandes authentifiées sont généralement limitées à 90 demandes par minute.
• Implémentez la limitation du taux dans votre code : utilisez des bibliothèques comme ratelimit dans Python pour vous assurer de rester dans les limites.

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @limits (appels = 90, période = 60)
 def call_api ():



# Make your API call here pass
 Utilisez la fonction
 call_api ()

Questions fréquemment posées

Q: Puis-je utiliser l'API REST de BitFinex pour automatiser les stratégies de trading?

R: Oui, vous pouvez utiliser l'API REST pour automatiser les stratégies de trading en passant par programme des commandes, en vérifiant les soldes et en récupérant les données du marché. Assurez-vous de mettre en œuvre une gestion des erreurs et une limitation des taux appropriés pour maintenir un environnement de trading stable.

Q: Est-il possible de retirer des fonds à l'aide de l'API BitFinex REST?

R: Oui, vous pouvez retirer des fonds à l'aide du point de terminaison /v1/withdraw . Vous devez spécifier la méthode, le montant et l'adresse de retrait. Assurez-vous d'avoir les autorisations nécessaires sur votre clé API pour effectuer des retraits.

Q: Comment puis-je tester mes demandes d'API sans affecter mon compte en direct?

R: BitFinex propose un environnement TestNet où vous pouvez tester vos demandes d'API sans affecter votre compte en direct. Vous pouvez vous inscrire à un compte TestNet et utiliser les points de terminaison API TestNet pour simuler le trading et d'autres opérations.

Q: Que dois-je faire si je rencontre une erreur d'authentification?

R: Si vous rencontrez une erreur d'authentification, vérifiez votre clé API, le secret et le processus de génération de signature. Assurez-vous que le nonce est unique pour chaque demande et que la charge utile est correctement formatée. Si les problèmes persistent, envisagez de régénérer votre clé API et votre secret.