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