Limites de fréquence publiques (données de marché)
Limites de fréquence privées (gestion de compte)
Limites de débit de trading (passage/annulation d’ordres)
Nos APIs REST et WebSocket sont soumises à des limites de fréquence qui restreignent le nombre d'appels pouvant être effectués sur une courte période. Ces limites de fréquence visent à protéger les APIs contre les attaques (notamment les attaques DDoS) et à prévenir la manipulation de nos carnets d'ordres (par exemple en plaçant et annulant rapidement des ordres importants).
Les limites de fréquence de l'API spot sont réparties en trois sections (publique, privée, trading) selon l'interface API utilisée (REST ou WebSocket) et le type d'appel effectué (données de marché, gestion de compte, placement/annulation d'ordres). Pour les limites de demandes associées aux appels API de contrats à terme (REST), consultez notre article de support ici.
Publique (données de marché REST)
Les points de terminaison publics spot sont soumis à des limites de fréquence par adresse IP et par paire de trading pour les appels aux transactions et aux données OHLC, et par adresse IP uniquement pour tous les autres points de terminaison publics.
Appeler les points de terminaison publics à une fréquence d'une fois par seconde (ou moins) permet de rester dans les limites de fréquence ; dépasser cette fréquence peut entraîner une restriction des appels. Si les limites de fréquence sont atteintes, les appels supplémentaires seront bloqués pendant quelques secondes (voire davantage si des appels continuent d'être effectués pendant cette période).
Privée (gestion de compte REST)
Les points de terminaison privés spot sont limités en débit par clé API et sont basés sur un compteur qui commence à 0, augmente à chaque appel et diminue au fil du temps. Le compteur de chaque clé API est indépendant ; si le compteur dépasse la valeur maximale, les appels suivants utilisant cette clé API seront soumis aux limites de fréquence. Si les limites de fréquence sont atteintes, les appels supplémentaires seront bloqués pendant quelques secondes (voire davantage si des appels continuent d'être effectués pendant cette période).
Point de terminaison API | Incrémentation du compteur (par demande) |
|---|---|
Points de terminaison d'historique de compte (Ledgers, TradesHistory, ClosedOrders) | +4 |
Points de terminaison de staking (Stake, Unstake) | +1 |
Tous les autres points de terminaison (Balance, TradeBalance, etc.) | +1 |
Points de terminaison de trading (AddOrder, CancelOrder, etc.) | 0 (sans effet sur le compteur) |
Niveau de compte | Valeur maximale du compteur | Décrémentation du compteur (par seconde) |
|---|---|---|
Standard | 20 | -0,5 |
Limites supérieures | 20 | -1 |
Trading (placement/annulation d'ordres via REST et WebSocket)
Les points de terminaison de trading spot (REST AddOrder/CancelOrder et WebSocket addOrder/cancelOrder) sont limités en débit par compte et par paire de devises, et sont basés sur la façon dont les ordres interagissent avec le carnet d’ordres.
En résumé, chaque compte et paire de trading dispose d'un nombre maximum de points utilisables par seconde avant d'atteindre les limites de fréquence de trading. Ces points sont utilisés pour passer, exécuter et annuler des ordres, tandis que le temps réapprovisionne ces points. Dépasser le nombre de points autorisé (selon le type de compte) entraîne la restriction des appels suivants.
Des détails complets sur les limites de débit de trading sont fournis afin que nos traders puissent calculer le nombre précis d’ordres qu’ils peuvent passer/exécuter/annuler en fonction de leur stratégie de trading (taux de remplissage des ordres, durée de vie des ordres sur le carnet d’ordres, etc.). Des exemples pour différents types de comptes et stratégies de trading de base sont fournis pour plus de commodité, ainsi qu’un calculateur de limite de débit afin de déterminer les limites de débit pour des stratégies plus complexes.