Lors de l'utilisation de l'API Binance pour le trading quantitatif ou l'analyse de donnees, comprendre les limites de frequence est indispensable. Un depassement entraine un blocage temporaire de l'IP, perturbant le trading normal.
Si vous n'avez pas encore de compte, inscrivez-vous d'abord via inscription Binance et creez une API Key. Sur mobile, vous pouvez aussi gerer l'API : telecharger l'appli Binance.
Regles de base des limites de frequence
L'API Binance a deux types principaux de limites :
Limite de poids des requetes : chaque endpoint API a un poids different. Les endpoints simples ont un poids de 1, les requetes complexes peuvent etre de 5 ou 10. Le poids total par minute ne doit pas depasser la limite (generalement 1200).
Limite de frequence d'ordres : il y a un plafond d'ordres par seconde et par jour. Maximum 10 ordres par seconde et 200 000 par jour.
Les limites specifiques varient selon les endpoints et les combinaisons de permissions — consultez la documentation officielle de l'API.
Comment surveiller votre consommation
Chaque reponse API contient dans les en-tetes (Response Header) l'utilisation actuelle du poids. Surveillez ces champs :
X-MBX-USED-WEIGHT-1M : poids utilise sur la derniere minute.
X-MBX-ORDER-COUNT-1S : nombre d'ordres dans la derniere seconde.
X-MBX-ORDER-COUNT-1D : nombre total d'ordres du jour.
Surveillez ces valeurs dans votre programme et ralentissez proactivement a l'approche des limites.
Que se passe-t-il en cas de depassement
Si vous depassez la limite de poids, vous recevrez un code HTTP 429 et votre IP sera temporairement bloquee, generalement pour quelques minutes. Pendant le blocage, toutes les requetes seront refusees.
En cas de depassement severe ou frequent, le blocage peut durer plus longtemps, voire plusieurs heures.
Comment eviter les depassements
Concevez des frequences de requetes raisonnables : pas de boucles infinies de requetes de marche, avec des intervalles raisonnables.
Utilisez WebSocket au lieu du polling : pour les donnees de marche en temps reel, les abonnements WebSocket ne consomment pas de poids de requete.
Traitement par lot : certaines operations supportent des interfaces en lot, comme les ordres groupes.
Mise en cache : les donnees ne necessitant pas de mise a jour en temps reel peuvent etre mises en cache localement pour reduire les requetes repetitives.
Que faire en cas de blocage
Les blocages temporaires se levent automatiquement — attendez quelques minutes avant de reessayer. Pour un blocage prolonge, contactez l'equipe de support API de Binance.
Pour eviter d'impacter le trading, ajoutez une logique de retry dans votre programme : en cas d'erreur 429, attendez automatiquement avant de reessayer.