Comment afficher les données historiques des chandeliers sur Binance

Accéder aux données de chandelier via l'interface Web Binance

1. Accédez à la page de trading au comptant de Binance et sélectionnez une paire de trading spécifique telle que BTC/USDT.

2. Localisez la zone du graphique et cliquez sur la liste déroulante des intervalles de temps. Les options incluent 1 m, 5 m, 15 m, 1 h, 4 h, 1 j, 1 w et 1 M.

3. Cliquez avec le bouton droit sur le canevas du graphique pour ouvrir le menu contextuel et choisissez « Exporter les données » pour télécharger des fichiers CSV contenant les champs d'ouverture, de haut, de bas, de fermeture, de volume et d'horodatage.

4. Ajustez la plage visible du graphique en faisant glisser horizontalement ou en utilisant le curseur de zoom en bas du widget graphique.

5. Passez la souris sur n'importe quelle bougie pour afficher les valeurs OHLCV précises et l'horodatage UTC dans une info-bulle.

Récupération de données historiques via l'API REST Binance

1. Construisez une requête GET sur https://api.binance.com/api/v3/klines avec des paramètres obligatoires : symbole (par exemple, ETHUSDT), intervalle (par exemple, 1 h) et startTime/endTime facultatif en millisecondes.

2. La réponse renvoie un tableau de 12 tableaux d'éléments, où chaque sous-tableau code le temps d'ouverture, le prix d'ouverture, le haut, le bas, la clôture, le volume, l'heure de clôture, le volume de l'actif de cotation, le nombre de transactions, le volume de base d'achat du preneur, le volume de cotation d'achat du preneur et le champ ignorer.

3. Utilisez le paramètre limit pour contrôler la taille du lot : le maximum autorisé est de 1 000 ; la pagination nécessite d'ajuster startTime à la dernière heure de fermeture plus une milliseconde.

4. Limites de débit de traitement : 1 200 requêtes par minute pour les points de terminaison publics ; le dépassement déclenche HTTP 429 avec l'en-tête Retry-After.

5. Validez les horodatages par rapport à l'heure du serveur obtenue à partir de /api/v3/time pour éviter les écarts ou les chevauchements induits par des biais dans les intervalles récupérés.

Utiliser Binance Cryptocurrency MCP pour les agents IA

1. Intégrez le service Model Context Protocol dans des frameworks d'agents tels que Claude ou Cursor pour émettre des requêtes en langage naturel sur les modèles de chandeliers.

2. Soumettez des invites telles que « Montrez-moi les données de chandelier sur 4 heures pour SOL/USDT du 1er octobre au 10 octobre 2026 » et recevez des réponses JSON structurées avec des tableaux kline complets.

3. Tirez parti de la normalisation intégrée des fenêtres horaires : les requêtes spécifiant les « 30 derniers jours » sont automatiquement résolues pour corriger les limites d'époque Unix alignées sur minuit UTC.

4. Validez de manière croisée la sortie par rapport aux résultats bruts de l'API lors du débogage des divergences dans la logique d'agrégation des bougies ou dans l'interprétation du fuseau horaire.

5. Analysez l'indicateur booléen « isFinal » dans les réponses pour distinguer les bougies finalisées des bougies provisoires encore soumises à des ajustements du côté de l'échange.

Considérations relatives à l'intégrité des données et à l'horodatage

1. Tous les horodatages de chandeliers reflètent l'heure de début de l'intervalle (et non l'heure de fin), donc une bougie 1d intitulée « 2026-10-15 » commence à 00:00:00 UTC et se termine à 23:59:59.999 UTC.

2. Les bougies manquantes se produisent uniquement pendant les fenêtres de maintenance de l'échange ou pendant les pannes d'infrastructure (et non en raison d'une faible liquidité) et ne sont jamais interpolées par les serveurs Binance.

3. Les valeurs de volume représentent uniquement le volume des actifs de base ; le volume des actifs de cotation doit être dérivé séparément en utilisant la multiplication des prix de clôture si nécessaire.

4. La génération de bougies côté serveur utilise des horodatages de correspondance d'ordres gérés par l'échange, et non des horodatages d'ingestion, garantissant ainsi la cohérence sur tous les canaux de données.

5. Les clients prenant en compte le fuseau horaire doivent convertir les entrées d'heure locale en UTC avant de soumettre des requêtes API, car Binance n'effectue pas de traduction automatique du fuseau horaire.

Foire aux questions

Q : Puis-je récupérer des données de chandelier datant de plus d'un an via l'API publique ? Oui. Le point de terminaison /api/v3/klines fournit des données historiques à partir de la date d'inscription de chaque symbole. BTC/USDT prend en charge les données depuis juillet 2017 ; les paires les plus récentes comme PEPE/USDT commencent à partir de leur date de lancement.

Q : Pourquoi les fichiers CSV exportés affichent-ils parfois moins de lignes que prévu pour une plage de dates donnée ? Cela se produit lorsque l'intervalle de temps sélectionné dépasse l'historique de trading disponible pour cette paire. Par exemple, demander des bougies de 1 W pour un jeton lancé il y a 10 jours ne donne qu'une seule ligne.

Q : Binance ajuste-t-il les bougies historiques après des annulations ou des corrections de transactions ? Non. Les bougies finalisées sont immuables une fois écrites. Seules les bougies en temps réel marquées « provisoires » peuvent changer avant la finalisation ; ces modifications sont reflétées dans les appels d'API ultérieurs avec le statut isFinal mis à jour.

Q : Existe-t-il un moyen de détecter les écarts dans la continuité des bougies sans inspection manuelle ? Comparez les valeurs closeTime séquentielles. Un écart existe si le openTime de la bougie suivante dépasse le closeTime + la durée de l'intervalle de la bougie actuelle. Les scripts peuvent automatiser cette validation sur des lots volumineux.