Si vous tradez des cryptomonnaies ou si vous voulez simplement analyser les flux d'ordres de Binance, vous êtes au bon endroit. Dans ce tutoriel, je vais vous montrer pas à pas comment récupérer les trades tick-by-tick des contrats perpétuels Binance en utilisant l'API Tardis, puis comment analyser ces données avec l'IA via S'inscrire ici HolySheep AI.
Je dois vous avouer : quand j'ai découvert Tardis il y a 18 mois, j'ai bataillé pendant trois jours avant de comprendre la structure des timestamps. Aujourd'hui, je vous épargne ces trois jours.
Qu'est-ce que Tardis API exactement ?
Tardis est un fournisseur historique de données de marché crypto. Concrètement, il archive chaque transaction exécutée sur Binance, Bybit, Coinbase, Kraken et 30+ autres plateformes — avec une profondeur historique qui remonte parfois à 2017.
Pour les contrats perpétuels (perps) Binance, chaque trade contient :
- Le prix exact d'exécution
- La quantité échangée
- L'heure à la microseconde près
- Le côté (acheteur ou vendeur initiateur)
- L'identifiant unique du trade
Ces données sont cruciales pour : le backtesting de stratégies, la détection de manipulations, l'analyse de microstructure, et l'entraînement de modèles quantitatifs.
Prérequis (rien de technique promis)
- Un ordinateur sous Windows, macOS ou Linux
- Python 3.10 ou plus récent (on va l'installer ensemble)
- Une connexion Internet stable
- Un compte Tardis (inscription gratuite en 2 minutes)
- ~10 € pour le plan Starter Tardis OU les crédits gratuits HolySheep pour l'analyse IA
Étape 1 : Créer un compte Tardis et récupérer sa clé API
Rendez-vous sur tardis.dev. Cliquez sur "Sign Up" en haut à droite.
[CAPTURE D'ÉCRAN 1 : Page d'accueil Tardis avec le bouton "Sign Up" en haut à droite]
Renseignez votre email, choisissez un mot de passe, validez l'email reçu. Une fois connecté, allez dans l'onglet "API Keys" dans votre dashboard.
[CAPTURE D'ÉCRAN 2 : Section "API Keys" du dashboard avec bouton "Generate New Key"]
Cliquez sur "Generate New Key", donnez-lui un nom (par exemple "mon-bot-python"), et copiez-la immédiatement — elle ne s'affiche qu'une seule fois. Formatez-la comme tardis-VotreCle:MonSecret selon la documentation officielle (schéma HTTP Basic Auth).
Étape 2 : Installer Python (5 minutes chrono)
Si vous avez déjà Python, sautez cette étape. Sinon :
[CAPTURE D'ÉCRAN 3 : Page python.org/downloads avec le bouton jaune "Download Python 3.12.x"]
Téléchargez l'installateur officiel sur python.org, cochez bien "Add Python to PATH" lors de l'installation, puis ouvrez un terminal (cmd sous Windows, Terminal sous macOS/Linux) et tapez :
python --versionSi vous voyez "Python 3.10" ou plus, c'est gagné.
Étape 3 : Installer la bibliothèque Python
Tardis fournit une bibliothèque officielle appelée tardis-client. Installez-la avec pip :
pip install tardis-client pandas requestsCette commande télécharge trois paquets : le client Tardis, pandas pour manipuler les données, et requests pour les appels HTTP bruts.
Étape 4 : Premier appel — récupérer 1 minute de trades BTCUSDT
Créez un fichier premier_trade.py avec votre éditeur préféré (VS Code, Notepad++, même le Bloc-notes fonctionne). Collez ce code :
import os
from tardis_client import TardisClient
import pandas as pd
1. Configuration — remplacez par votre vraie clé
API_KEY = "tardis-VotreCle:MonSecret"
2. Initialisation du client
tardis = TardisClient(api_key=API_KEY)
3. Requête : trades BTCUSDT perp entre 14h00 et 14h01 le 15 mars 2024
message_stream = tardis.replays.get_replay(
exchange="binance",
from_date="2024-03-15T14:00:00.000Z",
to_date="2024-03-15T14:01:00.000Z",
filters=[{"channel": "trades", "symbols": ["BTCUSDT"]