Questions fréquentes sur les API

2018-06-05 09:38

Dernière mise à jour : le 15 novembre 2024

Documentation APIBibliothèques et exemples d’API open source 

Quelles sont les limites ?

Aperçu

Il existe trois types de limites différentes, qui peuvent toutes être modifiées à tout moment :

  1. Limites strictes ;
  2. Limites ML (Machine Learning ou apprentissage automatique) ;
  3. Limites du pare-feu de l’application web (WAF).

Limites strictes

  • Charge de requêtes supérieure à 6 000 par minute (gardez à l’esprit que cela n’est pas nécessairement la même chose que traiter 6 000 requêtes)
  • 100 ordres toutes les 10 secondes
  • 200 000 ordres toutes les 24 heures

Nos limites strictes sont indiquées sur le point de terminaison [/api/v3/exchangeInfo].

Limites ML (Machine Learning, apprentissage automatique)

Le comportement de trading est évalué par rapport à l’utilisateur moyen. Si vous déviez trop loin, vous serez banni(e) pour une durée déterminée, allant de cinq minutes à trois jours.

Supposons que chaque utilisateur ait un score d’abus de trading. Votre score augmentera si :

  • Vous avez à plusieurs reprises fait du « front-run » sur la meilleure offre/demande du carnet d’ordres.
  • Création et annulation de vos ordres de masse sans exécuter de trades.
  • Votre « taux de conversion » est faible. Le « taux de conversion » est défini comme votre nombre de trades divisé par le nombre total de créations et d’annulations d’ordres sur une période de 24 heures (nombre de trades/(ordres + annulations)).
  • Votre « poids » est faible. Le « poids » est défini comme votre quantité tradée divisée par la quantité d’ordres créés et annulés sur une période de 24 heures (quantité totale tradée/(ordres + annulations)).
  • Lorsque vous tradez des paires dont l’actif de base ou de cotation est le BNB, votre score d’abus sera amplifié.

Des informations plus spécifiques que celles mentionnées ci-dessus ne seront pas fournies. Veuillez effectuer des tests pour définir votre modèle de trading idéal, ou discuter du comportement de l’API avec d’autres utilisateurs.

Limites du pare-feu de l’application Web (WAF)

Bien que nous ne fournissions pas de détails exacts sur nos règles WAF, si vous recevez une erreur HTTP 403, cela indique que vous avez enfreint une règle. Le plus souvent, il s’agit d’un nombre de demandes excessif réalisé sur une période de cinq minutes. Toutefois, si vous envoyez une demande qui pourrait être perçue comme malveillante, cela peut également entraîner une interdiction de plus longue durée.

Si je dépasse les limites, serai-je restreint au niveau du compte, de la clé API ou de l’adresse IP ?

Pour les limites strictes, dépasser le poids total de requêtes par minute (actuellement 6 000) entraînera un ban de l’adresse IP. Les limites d’ordre (actuellement 10 par seconde et 100 000 par 24 heures) dépendront du compte. Si la limite d’ordres a été dépassée, vous ne pourrez pas non plus passer de nouveaux ordres depuis l’interface Web (ou nos autres applications).

Pour les limites ML, des restrictions seront appliquées aux comptes. Si vous avez été restreint par le système ML, vous pouvez en vérifier la raison et la durée en utilisant le point de terminaison [/sapi/v1/account/status] (indiqué dans notre documentation API).

Les limitations du pare-feu de l’application web (WAF) seront appliquées à l’adresse IP. Généralement une interdiction WAF dure cinq minutes. Toutefois, si le serveur a interprété la requête d’un utilisateur comme étant malveillante, la durée peut être prolongée.

J’ai été restreint pour avoir dépassé les limites, mais j’ai corrigé mon code. Pouvez-vous restaurer mon accès plus rapidement ?

No. Vous devez attendre la fin de l’interdiction.

Pourquoi ai-je reçu une erreur HTTP 403 lors de l’utilisation de l’API ?

Vous avez enfreint les règles du WAF (Pare-feu d’application web), très probablement en violant une limite de débit ou en envoyant une requête malveillante (comme indiqué dans la section sur les limites de ce document). En général, ces restrictions durent cinq minutes.

Pourquoi mes connexions WebSocket sont-elles abandonnées/déconnectées ?

Toutes les trois minutes, les connexions WebSocket actives recevront un ping. Si vous ne répondez pas par un ping correctement formulé, votre connexion sera terminée.

Pour les flux de données utilisateurs, si un signal d’entretien n’est pas reçu au moins une fois toutes les 60 minutes, la clé d’écoute expirera. Ceci est également détaillé dans notre documentation API.

J’utilise un service/wrapper tiers, et cela ne fonctionne pas. Pouvez-vous m’aider ?

Malheureusement, nous ne prenons pas en charge les services ou outils tiers. Veuillez contacter le service et/ou les développeurs de ces outils pour obtenir de l’aide.

En outre, il est risqué de saisir vos clés API Binance et/ou vos clés secrètes sur n’importe quelle plateforme tierce. Veuillez utiliser ces services à votre propre convenance.

N’oubliez pas que nous évitons également de fournir une assistance en matière de programmation.

Je reçois des erreurs de façon inattendue alors que je n’ai apporté aucune modification. Que s’est-il passé ?

Malheureusement, nous ne sommes pas en mesure de fournir une assistance pour les problèmes liés à votre mise en œuvre personnelle. Si vous utilisez un wrapper/outil tiers, veuillez contacter l’équipe du service client de ce service pour obtenir de l’assistance.

Je dois accéder à ma clé secrète, mais elle affiche « *** ». Comment la consulter ?

Pour des raisons de sécurité, la clé secrète n’est visible qu’au moment de la création de la clé API. Elles sera systématiquement masquée ensuite. Si vous l’avez perdue ou si vous ne l’avez pas enregistrée, vous devrez créer une nouvelle clé API et l’utiliser avec une nouvelle clé secrète.

Puis-je augmenter mes limites ou ma bande passante dédiée ?

Malheureusement, cela n’est actuellement pas proposé... Vous devez respecter les limites définies.

Ma clé API a disparu.

Il n’y a que deux explications plausibles expliquant la « disparition » d’une clé API :

  • Si vous n’avez pas été actif récemment et que vous utilisiez l’API avant le 7 mars 2018, il est possible que votre ou vos clés API aient été purgées pour assurer la sécurité de votre compte.
  • 2. Si vous avez désactivé votre compte, cela entraînera la suppression de toutes les clés API actives.

Vous devriez être en mesure de créer une ou plusieurs nouvelles clés API sans problème.

Je reçois le message « Erreur-1021 [Message : Timestamp for this request is outside of the recvWindow ; L’horodatage de cette demande se situe en dehors de la fenêtre de réception (recvWindow)] ». Comment puis-je résoudre ce problème ?

En général, cette erreur ne se produit que si l’heure du serveur et l’heure de votre système ne sont pas synchronisées. Vous devrez peut-être synchroniser votre horloge système. Cependant, ce processus varie en fonction du système d’exploitation utilisé.

Pour Windows, à votre seule discrétion, vous pouvez utiliser la fonction « Régler l’heure automatiquement ». Les utilisateurs Linux et Mac peuvent essayer de synchroniser avec « ntpdate » via la ligne de commande.

Si le problème persiste, il est peut-être lié à la latence (problème réseau). Veuillez essayer d’ajuster votre recvWindow.

Puis-je demander de nouvelles fonctionnalités API ?

Si vous ne voyez pas la fonctionnalité que vous cherchez dans notre documentation, cela indique que nous ne la proposons pas. Pour faire une suggestion de fonctionnalité, vous pouvez ouvrir un ticket de support avec votre suggestion, celle-ci fera alors l’objet d’une étude.

Je crois qu’il y a un problème avec l’API. Comment dois-je le signaler ?

Si vous pensez qu’il y a un problème avec le système et non avec votre mise en œuvre, veuillez fournir des preuves pour appuyer votre signalement en nous contactant dans notre forum pour développeurs, et nous enquêterons. Veuillez remarquer que nous ne ferons pas de recherches suite à une demande exprimée de façon vague.