Comment afficher les enregistrements de transaction API sur Bybit? Y a-t-il une limite au nombre de transactions?

L'API de Bybit permet aux utilisateurs de récupérer les enregistrements de transaction à l'aide du point de terminaison / V2 / Private / Wallet / Transaction-Log, avec des limites sur le taux et l'accès historique des données.

May 19, 2025 at 07:07 am

Bybit est un échange de crypto-monnaie populaire qui fournit des services d'API robustes pour les commerçants qui souhaitent automatiser leurs stratégies de trading ou gérer leurs portefeuilles par programme. L'une des principales fonctionnalités auxquelles les utilisateurs ont souvent besoin d'accéder via l'API est les enregistrements de transaction. Cet article vous guidera tout au long du processus de visualisation des enregistrements de transaction API sur Bybit et discutera de toutes les limites qui pourraient être en place sur le nombre de transactions que vous pouvez récupérer.

Comprendre l'API de Bybit

Avant de plonger dans les détails de la récupération des enregistrements de transaction, il est essentiel de comprendre les bases de l'API de Bybit. L'API de Bybit permet aux utilisateurs d'interagir avec la plate-forme par programme. Cela comprend l'exécution des transactions, la gestion des commandes et la récupération de diverses données telles que les enregistrements de transaction. L'API est conçue pour être sécurisée et efficace, garantissant que les utilisateurs peuvent gérer efficacement leurs comptes.

Accéder à l'API

Pour commencer à utiliser l'API de Bybit, vous devez configurer une clé API. Voici les étapes pour le faire:

• Connectez-vous à votre compte de recours .
• Accédez à la section de gestion des API . Cela peut généralement être trouvé dans les paramètres du compte ou la section de profil utilisateur.
• Créez une nouvelle clé API . Vous devrez fournir un nom pour la clé et définir les autorisations en fonction de vos besoins.
• Enregistrez la clé de l'API et le secret . Ceux-ci seront utilisés pour authentifier vos demandes d'API.

Récupération des enregistrements de transaction

Une fois que vous avez configuré votre clé API, vous pouvez commencer à faire des demandes pour récupérer des enregistrements de transaction. L'API de Bybit fournit des points de terminaison spécialement conçus pour récupérer les données de transaction. Le point de terminaison que vous utiliserez est / v2 / private / wallet / transaction-log .

Voici comment faire une demande à ce point de terminaison:

• Préparez votre demande . Vous devrez inclure votre clé API et vous secret dans les en-têtes de demande pour l'authentifier.
• Spécifiez les paramètres . Vous pouvez filtrer les enregistrements de transaction en spécifiant des paramètres tels que currency , start_date , end_date et exec_type . Ces paramètres vous aident à réduire les résultats des transactions qui vous intéressent.
• Envoyer la demande . Utilisez un outil comme Postman ou écrivez un script dans votre langage de programmation préféré pour envoyer la demande au serveur API de Bybit.

Voici un exemple de ce à quoi la demande pourrait ressembler à Python à l'aide de la bibliothèque requests :

 import requests
 import time api_key = 'your_api_key'
 api_secret = 'your_api_secret'
 base_url = 'https://api.bybit.com'
 endpoint = '/ v2 / private / wallet / transaction-log'



Préparez les paramètres
 params = {


'currency': 'BTC', 'start_date': '2023-01-01', 'end_date': '2023-01-31', 'exec_type': 'Deposit'
 }
 
Générer l'horodatage
 Timestamp = int (time.time () * 1000)
 
Préparer les en-têtes
 en-têtes = {
 
'Content-Type': 'application/json', 'api_key': api_key, 'timestamp': str(timestamp), 'sign': generate_signature(api_secret, timestamp, params) # You need to implement the generate_signature function
 }
 
Envoyer la demande
 Response = requers.get (base_url + point de terminaison, en-têtes = en-têtes, params = params)
 
Traiter la réponse
 Si réponse.status_code == 200:
 
print(response.json())
 autre:
 
print(f'Error: {response.status_code}')
 Comprendre la réponse
 Lorsque vous récupérez avec succès les enregistrements de transaction, l'API de Bybit renverra une réponse JSON contenant les données demandées. La réponse comprendra des champs tels que id , time , currency , amount , type et status . Il est important d'analyser correctement ces données pour donner un sens à l'historique de votre transaction.
 
Voici un exemple de ce à quoi pourrait ressembler la réponse:
 
{
 'ret_code': 0,
 'ret_msg': 'ok',
 'ext_code': '',
 'ext_info': '',
 'résultat': {
 
'data': [ { 'id': '123456', 'time': '2023-01-05T12:34:56Z', 'currency': 'BTC', 'amount': '0.1', 'type': 'Deposit', 'status': 'Success' }, { 'id': '123457', 'time': '2023-01-10T12:34:56Z', 'currency': 'BTC', 'amount': '0.2', 'type': 'Withdrawal', 'status': 'Success' } ]
 }
 }

Limites sur les enregistrements de transaction

Bybit impose certaines limites au nombre de transactions que vous pouvez récupérer via l'API. Ces limites sont en place pour prévenir les abus et assurer une utilisation équitable des ressources de la plateforme. Voici quelques points clés à garder à l'esprit:

• Limites de taux : Bybit a des limites de taux sur les demandes d'API. Par exemple, vous pourriez être limité à un certain nombre de demandes par minute ou par jour. Le dépassement de ces limites peut entraîner le bloqué temporairement de votre clé API.
• Pagination : Lors de la récupération des enregistrements de transaction, Bybit utilise la pagination pour gérer de grands ensembles de données. Vous pouvez spécifier le paramètre limit pour contrôler le nombre d'enregistrements renvoyés dans chaque réponse et utiliser le paramètre page pour parcourir plusieurs pages de résultats.
• Données historiques : il peut y avoir des limites à la distance de récupération des enregistrements de transaction. Bybit vous permet généralement de récupérer des données pendant un certain nombre de jours ou de mois dans le passé.

Pour gérer ces limites efficacement, vous devriez:

• Surveillez votre utilisation de l'API . Gardez une trace du nombre de demandes que vous faites et assurez-vous de rester dans les limites de taux.
• Mettre en œuvre la pagination . Utilisez la limit et les paramètres page pour récupérer des données dans des morceaux gérables.
• Planifiez votre récupération de données . Si vous devez récupérer une grande quantité de données historiques, planifiez soigneusement vos demandes pour éviter de frapper les limites.

Gestion des erreurs

Lorsque vous travaillez avec l'API de Bybit, vous pouvez rencontrer des erreurs. Les erreurs communes incluent les défaillances d'authentification, la limite de taux dépassée et les paramètres non valides. Voici comment gérer ces erreurs:

• Erreurs d'authentification : si vous recevez une erreur d'authentification, vérifiez votre clé API et votre secret. Assurez-vous qu'ils sont correctement inclus dans les en-têtes de demande.
• Erreurs de limite de taux : si vous dépassez la limite de taux, attendez une période avant de réessayer votre demande. Implémentez un retard dans votre code pour éviter d'atteindre la limite de taux à plusieurs reprises.
• Paramètres non valides : si l'API renvoie une erreur due aux paramètres non valides, passez en revue votre demande et assurez-vous que tous les paramètres sont correctement formatés et dans la plage acceptable.

FAQ

Q: Puis-je récupérer les enregistrements de transaction pour plusieurs devises à la fois en utilisant l'API de Bybit?

R: Non, l'API de Bybit vous oblige à spécifier une seule devise lors de la récupération des enregistrements de transaction. Si vous avez besoin d'enregistrements pour plusieurs devises, vous devrez faire des demandes d'API distinctes pour chaque devise.

Q: Comment puis-je assurer la sécurité de ma clé API lors de la récupération des enregistrements de transaction?

R: Pour assurer la sécurité de votre clé API, ne le partagez jamais avec personne et ne l'utilisez que dans des environnements sécurisés. De plus, envisagez d'utiliser la fonction de liste blanche IP de Bybit pour restreindre l'accès à l'API à des adresses IP spécifiques.

Q: Existe-t-il un moyen d'automatiser la récupération des enregistrements de transaction sur un calendrier?

R: Oui, vous pouvez automatiser la récupération des enregistrements de transaction en écrivant un script qui fait des demandes d'API sur un calendrier. Utilisez un outil de planification comme les travaux CRON sur les systèmes ou le planificateur de tâches basés sur UNIX sur Windows pour exécuter votre script à intervalles réguliers.

Q: Que dois-je faire si je rencontre une erreur de 429 trop de demandes?

R: Si vous rencontrez une erreur de 429, cela signifie que vous avez dépassé les limites de taux de BEBIT. Attendez une période avant de réessayer votre demande et envisagez de mettre en œuvre un retard dans votre code pour éviter d'atteindre la limite de taux à plusieurs reprises.