Обмеження швидкості для публічних (ринкових даних) API
Обмеження швидкості для приватних (управління обліковим записом) API
Обмеження швидкості для торгівлі (розміщення/скасування ордерів) API
Наші REST та WebSocket API мають обмеження швидкості, які впливають на кількість викликів, що можуть бути здійснені протягом короткого проміжку часу. Обмеження швидкості розроблені для захисту API від атак (таких як DDoS-атаки) та для запобігання маніпуляціям з нашими книгами ордерів (наприклад, шляхом швидкого розміщення та скасування великих ордерів).
Обмеження швидкості Spot API поділяються на три розділи (публічні, приватні, торгові) залежно від використовуваного інтерфейсу API (REST або WebSocket) та типу виклику (ринкові дані, управління обліковим записом, розміщення/скасування ордерів). Щодо обмежень запитів, пов'язаних з викликами Futures (REST) API, будь ласка, перегляньте нашу статтю підтримки тут.
Публічні (ринкові дані REST)
Публічні кінцеві точки Spot API мають обмеження швидкості за IP-адресою та валютною парою для викликів Trades та OHLC, а також лише за IP-адресою для викликів до всіх інших публічних кінцевих точок.
Виклики публічних кінцевих точок з частотою 1 на секунду (або менше) залишатимуться в межах обмежень швидкості, але перевищення цієї частоти може призвести до обмеження швидкості викликів. Якщо обмеження швидкості досягнуто, додаткові виклики будуть обмежені на кілька секунд (або, можливо, довше, якщо виклики продовжуватимуться, поки обмеження швидкості активні).
Приватні (управління обліковим записом REST)
Приватні кінцеві точки Spot API мають обмеження швидкості за ключем API і базуються на лічильнику, який починається з 0, збільшується з кожним викликом і зменшується з часом. Лічильник кожного ключа API є окремим, і якщо лічильник перевищує максимальне значення, подальші виклики за допомогою цього ключа API будуть обмежені за швидкістю. Якщо обмеження швидкості досягнуто, додаткові виклики будуть обмежені на кілька секунд (або, можливо, довше, якщо виклики продовжуватимуться, поки обмеження швидкості активні).
Кінцева точка API | Збільшення лічильника (за запит) |
|---|---|
Кінцеві точки історії облікового запису (Ledgers, TradesHistory, ClosedOrders) | +4 |
Кінцеві точки стейкінгу (Stake, Unstake) | +1 |
Усі інші кінцеві точки (Balance, TradeBalance тощо) | +1 |
Торгові кінцеві точки (AddOrder, CancelOrder тощо) | 0 (без впливу на лічильник) |
Рівень верифікації облікового запису | Максимальне значення лічильника | Зменшення лічильника (за секунду) |
|---|---|---|
Верифікований | 20 | -0.5 |
Верифікований з вищими лімітами | 20 | -1 |
Торгівля (розміщення/скасування ордерів REST та WebSocket)
Торгові кінцеві точки Spot API (REST AddOrder/CancelOrder та WebSocket addOrder/cancelOrder) мають обмеження швидкості за обліковим записом та за валютною парою, і базуються на тому, як ордери взаємодіють з книгою ордерів.
Коротко (версія TLDR): кожен обліковий запис та валютна пара мають максимальну кількість балів, які можна використовувати щосекунди, не досягаючи обмежень швидкості торгівлі. Розміщення, виконання та скасування ордерів використовує ці бали, тоді як час поповнює ці бали. Використання більшої кількості балів, ніж дозволено (залежно від типу вашого облікового запису), призведе до обмеження швидкості подальших викликів.
Повні деталі обмежень швидкості торгівлі надаються, щоб наші трейдери могли розрахувати точну кількість ордерів, які вони можуть розміщувати/виконувати/скасовувати на основі своєї торгової стратегії (швидкість виконання ордерів, термін життя ордера в книзі ордерів тощо). Приклади для різних типів облікових записів та базових торгових стратегій надаються для зручності, разом з калькулятором обмежень швидкості для визначення обмежень швидкості для більш складних стратегій.