Ліміти запитів для публічного API (ринкові дані)
Ліміти запитів для приватного API (керування обліковим записом)
Ліміти запитів для торгівлі (виставлення/скасування ордерів)
Наші REST і WebSocket API мають ліміти запитів, що обмежують кількість викликів, які можна здійснити за короткий проміжок часу. Ліміти запитів призначені для захисту API від атак (наприклад, DDoS-атак) і запобігання маніпуляціям із книгами ордерів (наприклад, через масове швидке виставлення та скасування ордерів).
Ліміти запитів Spot API поділяються на три категорії (публічний, приватний, торговий) залежно від типу інтерфейсу API (REST або WebSocket) і типу виклику (ринкові дані, керування обліковим записом, виставлення/скасування ордерів). Інформацію про ліміти запитів для викликів Futures (REST) API наведено в статті нашої Служби підтримки тут.
Публічний API (ринкові дані, REST)
Для публічних кінцевих точок Spot ліміти запитів встановлюються за IP-адресою та валютною парою для викликів Trades і OHLC, а для решти публічних кінцевих точок — лише за IP-адресою.
Звернення до публічних кінцевих точок із частотою не більше 1 разу на секунду не перевищує лімітів запитів, однак вища частота може призвести до їх обмеження. Якщо ліміти запитів вичерпано, подальші виклики буде заблоковано на кілька секунд (або довше, якщо виклики продовжуються під час дії обмежень).
Приватний API (керування обліковим записом, REST)
Для приватних кінцевих точок Spot ліміти запитів встановлюються за ключем 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)
Кінцеві точки спот-торгівлі (REST AddOrder/CancelOrder і WebSocket addOrder/cancelOrder) мають ліміти запитів на рівні облікового запису та валютної пари й ґрунтуються на тому, як ордери взаємодіють із книгою ордерів.
Коротко (версія TLDR): кожен обліковий запис і валютна пара мають максимальну кількість балів, які можна використовувати щосекунди, не перевищуючи торгових лімітів запитів. Розміщення, виконання та скасування ордерів витрачає ці бали, тоді як з часом вони поповнюються. Перевищення дозволеної кількості балів (залежно від типу Вашого облікового запису) призведе до обмеження подальших запитів.
Повні відомості про торгові ліміти запитів надано для того, щоб трейдери могли розрахувати точну кількість ордерів, які вони можуть розмістити/виконати/скасувати відповідно до своєї торгової стратегії (коефіцієнт заповнення ордерів, час перебування ордера в книзі ордерів тощо). Для зручності наведено приклади для різних типів облікових записів і базових торгових стратегій, а також калькулятор лімітів запитів для визначення лімітів для складніших стратегій.