Comment accéder aux données de négociation historiques contre des contrats de recours?

Bybit fournit des données sur le commerce des contrats historiques via l'API ou l'interface Web, permettant des backtesting et une analyse pour les contrats perpétuels et à terme.

Aug 13, 2025 at 11:36 am

Comprendre les données de trading historique sur le recours

Les données sur les échanges historiques pour les contrats de Bybt se réfèrent aux enregistrements antérieurs des transactions exécutées, y compris des informations telles que le prix, la quantité, l'horodatage, le côté (acheter / vendre) et le type de contrat . Ces données sont essentielles pour les commerçants qui s'engagent dans une analyse technique, des stratégies de backtesting ou l'audit de leurs performances commerciales. Bybit donne accès à ces données via plusieurs méthodes, y compris son API officielle et son interface Web. Les données couvrent généralement les contrats perpétuels et les contrats à terme sur diverses crypto-monnaies comme BTCUSD, Ethusd et autres.

Il est important de faire la distinction entre l'histoire du commerce public et l'histoire du commerce personnel . Les données publiques reflètent tous les métiers exécutés sur le carnet de commandes et sont disponibles pour tout utilisateur. L'historique du commerce personnel ne comprend que les métiers exécutés par votre compte et nécessite l'authentification pour accéder. Les deux types de données sont structurés au format JSON lorsqu'ils sont récupérés via l'API, ce qui les rend adaptés à l'intégration dans les outils analytiques.

Accéder à l'historique du commerce public via l'API Bybit

Pour récupérer les données publiques du commerce historique pour les contrats de recours, utilisez le point de terminaison officiel de l'API REST de repos:

• Point de terminaison de l'API : https://api.bybit.com/v5/market/recent-trade

Ce point de terminaison renvoie les métiers les plus récents pour un symbole spécifié. Pour accéder aux enregistrements historiques plus profonds, vous devez paginer en utilisant le paramètre de curseur renvoyé dans chaque réponse. Voici comment faire la demande:

• Utilisez une demande de GET HTTP avec les paramètres requis:
  • category : réglé sur des contrats linear pour USDT ou inverse pour les contrats inverses
  • symbol : spécifiez le contrat, par exemple, BTCUSDT
  • limit : nombre d'enregistrements par demande (maximum 1000)
  • cursor : utilisez le curseur de la réponse précédente pour récupérer le lot suivant

Exemple de demande dans Python:

 import requests url = 'https://api.bybit.com/v5/market/recent-trade'
 params = {



'category': 'linear', 'symbol': 'BTCUSDT', 'limit': 100
 }
 
Response = requers.get (URL, params = params)
 data = réponse.json ()

Le JSON retourné comprend des champs comme le prix, la taille, le côté, le temps et le symbole . Pour récupérer des données plus anciennes, extraire le curseur du champ next_page_cursor et incluez-les dans la demande suivante.

Récupération de l'historique du commerce personnel à l'aide de l'authentification API

Pour accéder à votre historique de commerce de contrat personnel , une authentification est requise. Vous devez générer une clé API avec les autorisations «Order» et «Lire» à partir de vos paramètres de compte Bybit. Le point de terminaison pertinent est:

• Point de terminaison de l'API : https://api.bybit.com/v5/order/execution-list

Ce point de terminaison renvoie les commandes contractuelles remplies associées à votre compte. Les paramètres requis incluent:

• category : linear ou inverse
• symbol : par exemple, BTCUSDT
• start_time et end_time : horodatage Unix pour définir la plage de temps
• limit : MAX 50 Records par demande
• api_key , timestamp et sign : en-têtes d'authentification

Étapes pour générer la demande:

• Générer un horodatage en millisecondes
• Créez une signature en utilisant HMAC SHA256 avec votre secret API
• Inclure les en-têtes: X-BAPI-API-KEY , X-BAPI-TIMESTAMP , X-BAPI-SIGN

Exemple de code python pour la signature:

 import hmac
 import time api_key = 'your_api_key'
 api_secret = 'your_api_secret'
 Timestamp = str (int (time.time () * 1000))



param_str = f'category = linéaire & symbol = btcusdt & limite = 50 & start_time = 1700000000000 & end_time = 1701000000000 '
 signature = hmac.new (api_secret.encode (), param_str.encode (), digestmod = 'sha256'). hexdigest ()


en-têtes = {


'X-BAPI-API-KEY': api_key, 'X-BAPI-TIMESTAMP': timestamp, 'X-BAPI-SIGN': signature
 }
 
Response = requers.get (URL, params = params, en-têtes = en-têtes)

Chaque enregistrement comprend Exec_price, Exec_qty, Side, Fee et Order_id .

Utilisation de l'interface Web Bybit pour l'historique du commerce

Pour les utilisateurs qui préfèrent ne pas utiliser les API, Bybit propose une interface Web pour afficher l'historique du commerce des contrats personnels. Connectez-vous à votre compte Bybit et accédez à:

• Dérivés → Ordre → Historique commercial

Ici, vous pouvez:

• Sélectionnez des contrats linéaires ou des contrats inverses
• Choisissez un symbole spécifique dans la liste déroulante
• Filtre par plage de dates
• Exporter jusqu'à 100 enregistrements à la fois au format CSV

Les colonnes affichées incluent le symbole, le côté, la quantité, le prix, les frais, le PNL fermé et le temps . Notez que l'interface Web n'autorise pas l'exportation en vrac de toutes les données historiques en un seul clic. Vous devez paginer manuellement via les dates et télécharger plusieurs fichiers CSV si nécessaire.

Traitement et stockage des données historiques

Une fois récupérés, les données commerciales historiques devraient être stockées pour analyse. Les formats recommandés incluent les tables CSV, parquet ou de base de données . Pour la collecte continue de données, configurez un travail ou un script CRON qui appelle périodiquement l'API et ajoute de nouveaux enregistrements.

Considérations clés:

• Limites de taux : le recours autorise 60 demandes par minute pour les critères de terminaison publics et 120 pour privé
• Déduplication des données : utilisez exec_id ou trad_time comme identificateurs uniques
• Manipulation du fuseau horaire : tous les horodatages sont en UTC
• Rétention des données : Bybit conserve l'historique du commerce personnel pendant jusqu'à 6 mois sur l'interface Web, mais l'accès à l'API peut permettre la récupération des données plus anciennes en fonction de l'activité du compte

Stockez les données dans les répertoires structurés:

 /trade_data/
 /public/ btcusdt_20231201.csv

/privé/

my_trades_20231201.csv

Utilisez des pandas en python pour fusionner et analyser:

import pandas as pd

df = pd.read_csv ('btcusdt_20231201.csv')
df ['time'] = pd.to_datetime (df ['time'], unit = 'ms')

Questions fréquemment posées

Jusqu'où se déroule l'historique du commerce des contrats de Bybit?

L'API publique de Bybit conserve généralement des données commerciales récentes jusqu'à 7 jours dans le point final recent-trade . Pour les données publiques plus anciennes, des agrégateurs tiers ou des scripts de collecte de données personnalisés sont nécessaires. L'historique du commerce personnel via l'API privé peut revenir en arrière plusieurs mois , selon la date de création du compte et la politique de rétention interne de Bybit.

Puis-je obtenir des données historiques au niveau des tiques pour les backtesting?

Oui, le point de terminaison /v5/market/recent-trade fournit des données au niveau des tiques, y compris le prix et le volume par échange. Pour construire un historique complet de tiques, vous devez continuellement interroger l'API ou utiliser WebSocket Streams ( publicTrade Topic) pour capturer des métiers en temps réel et les stocker.

Pourquoi est-ce que je reçois une erreur de «signature non valide» lors de l'accès aux données privées?

Cette erreur se produit lorsque la signature HMAC ne correspond pas . Assurez-vous que la chaîne de paramètre est correctement triée par ordre alphabétique, l'horodatage est en millisecondes et le secret de l'API est correctement entré. Vérifiez également que la méthode HTTP (GET / POST) correspond au format attendu pour le point de terminaison.

Les données historiques sont-elles disponibles pour les contrats à terme expirés?

Oui, les données commerciales historiques pour les contrats à terme expirés sont accessibles via l'API en spécifiant le nom de symbole correct utilisé pendant la période active du contrat . Par exemple, BTCUSD231229 pour les contrats à terme inverse de décembre 2023 BTC. Les mêmes points de terminaison API s'appliquent, avec category=inverse et le symbole approprié.