Comment interroger les soldes du compte à l'aide de l'API de BitFinex?

Utilisez l'API de BitFinex pour interroger les soldes du compte en s'authentifiez avec les clés de l'API, en construisant une demande post-demande à / v2 / auth / r / portefeuille et en analysant la réponse JSON.

Apr 13, 2025 at 03:21 pm

Comment interroger les soldes du compte à l'aide de l'API de BitFinex?

BitFinex, l'un des principaux échanges de crypto-monnaie, fournit une API robuste qui permet aux utilisateurs d'interagir avec leur plate-forme par programme. L'une des opérations les plus courantes que les utilisateurs effectuent consiste à interroger les soldes de compte. Cet article vous guidera tout au long du processus d'utilisation de l'API de BitFinex pour vérifier les soldes de votre compte, en vous assurant de gérer vos fonds efficacement et en toute sécurité.

Comprendre l'authentification de l'API de BitFinex

Avant de pouvoir interroger les soldes de votre compte, vous devez comprendre comment authentifier vos demandes d'API. BitFinex utilise une combinaison de clés API et une signature pour garantir un accès sécurisé à votre compte.

• Générez des touches API : connectez-vous à votre compte BitFinex, accédez à la section API et générez une nouvelle clé API. Assurez-vous d'activer les autorisations nécessaires pour la lecture des soldes du compte.
• Clé API et secret : vous recevrez une clé API et une clé secrète. Gardez la clé secrète en sécurité et ne le partagez jamais.
• Création de la signature : Pour chaque demande d'API, vous devez créer une signature en utilisant la clé secrète. La signature est générée en hachant la charge utile de demande avec la clé secrète.

Configuration de votre environnement de développement

Pour interagir avec l'API de BitFinex, vous devez configurer votre environnement de développement. Voici comment le faire:

• Choisissez un langage de programmation : L'API de BitFinex peut être utilisée avec divers langages de programmation. Les choix populaires incluent Python, JavaScript et Ruby.
• Installez les bibliothèques requises : par exemple, si vous choisissez Python, vous pouvez utiliser la bibliothèque requests pour fabriquer des demandes HTTP et hmac et hashlib pour créer la signature.
• Configurez vos informations d'identification API : stockez votre clé API et votre clé secrète en toute sécurité dans votre environnement de développement.

Construire la demande d'API

Pour interroger les soldes de votre compte, vous devez construire une demande d'API au point de terminaison approprié. BitFinex fournit le point de terminaison /v2/auth/r/wallets à cet effet.

• Point de terminaison : https://api.bitfinex.com/v2/auth/r/wallets
• Méthode HTTP : POST
• Charge utile : un tableau vide [] est utilisé pour cette demande.

Créer la signature

La création de la signature est une étape cruciale dans l'authentification de votre demande. Voici comment le faire:

• Horodatage : générer un horodatage en millisecondes. Cet horodatage doit être inclus dans la charge utile.
• Nonce : utilisez l'horodatage comme nonce pour vous assurer que la demande est unique.
• Télélée utile : construire la charge utile en concaténant le chemin de l'API et la charge utile en codé JSON.
• Signature : Utilisez l'algorithme HMAC-SHA384 pour créer la signature avec votre clé secrète et la charge utile.

Voici un exemple de la façon de créer la signature dans Python:

 import time
 import json
 import hmac
 import hashlib api_key = 'your_api_key'
 api_secret = 'your_api_secret'



Générer l'horodatage et nonce
 Timestamp = str (int (time.time () * 1000))
 nonce = horodatage


Construire la charge utile
 Payload = '/ api / v2 / auth / r / wallet' + json.dumps ([])


Créer la signature
 signature = hmac.new (api_secret.encode (), upload.encode (), hashlib.sha384) .hexdigest ()

Envoi de la demande d'API

Une fois que vous avez construit la charge utile et créé la signature, vous pouvez envoyer la demande d'API. Voici comment le faire en Python:

• En-têtes : incluez la clé API, la signature et le nonce dans les en-têtes de votre demande.
• Envoyez la demande : utilisez la bibliothèque requests pour envoyer la demande de poste au point de terminaison.

Voici un exemple de la façon d'envoyer la demande dans Python:

 import requests url = 'https://api.bitfinex.com/v2/auth/r/wallets'



en-têtes = {


'bfx-nonce': nonce, 'bfx-apikey': api_key, 'bfx-signature': signature
 }
 
Response = requers.Post (URL, en-têtes = en-têtes, données = json.dumps ([]))
 
Si réponse.status_code == 200:
 
print(response.json())
 autre:
 
print('Error:', response.status_code, response.text)
 Analyser la réponse
 Après avoir envoyé la demande, vous devez analyser la réponse pour extraire les soldes de votre compte. La réponse de BitFinex sera au format JSON, contenant un tableau d'objets de portefeuille.
 
Objets de portefeuille : Chaque objet de portefeuille comprend des informations telles que la devise, l'équilibre et le type de portefeuille (par exemple, échange ou marge).
 Extraction des soldes : itérez dans le tableau pour extraire le solde de chaque devise.
 Voici un exemple de la façon d'analyser la réponse dans Python:
 
wallets = response.json()
 pour le portefeuille dans les portefeuilles:
 
currency = wallet[1] balance = wallet[2] print(f'Currency: {currency}, Balance: {balance}')
 Gestion des erreurs et des cas de bord
 Lorsque vous interrogez les soldes du compte, il est important de gérer les erreurs potentielles et les cas de bord:
 
Limites de taux de l'API : BitFinex a des limites de taux sur les demandes d'API. Assurez-vous de ne pas dépasser ces limites pour éviter d'être bloqué.
 Erreurs d'authentification : si votre signature ou nonce est incorrecte, vous recevrez une erreur d'authentification. Vérifiez votre processus d'authentification.
 Problèmes de réseau : soyez prêt à gérer les problèmes liés au réseau, tels que les délais ou les erreurs de connexion.
 Questions fréquemment posées
 Q: Puis-je interroger les soldes du compte pour plusieurs comptes en utilisant la même clé API?
 
R: Non, chaque clé API est liée à un seul compte. Pour interroger les soldes pour plusieurs comptes, vous devez générer des clés API distinctes pour chaque compte.
 
Q: À quelle fréquence puis-je interroger les soldes de mon compte en utilisant l'API de BitFinex?
 
R: BitFinex impose les limites de taux aux demandes d'API. Vous pouvez généralement faire jusqu'à 90 demandes par minute, mais il est préférable de vérifier les limites actuelles dans la documentation de l'API BitFinex.
 
Q: Que dois-je faire si je rencontre une erreur d'authentification lors de l'interrogation des soldes de mon compte?
 
R: Les erreurs d'authentification se produisent généralement en raison de signatures incorrectes ou de valeurs non ECE. Assurez-vous que votre horodatage est précis et que vous utilisez la clé secrète correcte pour générer la signature. Si le problème persiste, régénérez vos clés API et réessayez.
 
Q: Puis-je utiliser l'API de BitFinex pour interroger les soldes du compte en temps réel?
 
R: L'API de BitFinex ne fournit pas de streaming en temps réel des soldes de compte. Vous devez faire des demandes périodiques au point de terminaison /v2/auth/r/wallets pour obtenir les derniers soldes.