API документація丨Бібліотеки з відкритим вихідним кодом API і приклади
Які ліміти?
Огляд
Існує три різних типи лімітів, кожен з яких може бути змінений у будь-який час:
- Жорсткі ліміти
- Ліміти ML (Машинного навчання)
- Ліміти WAF (Файрвол веб-додатків)
Жорсткі ліміти
- 6000 одиниць ваги запиту на хвилину (зверніть увагу, що цей показник не обов’язково відповідає 6000 запитам)
- 50 ордерів за 10 секунд
- 160 000 ордерів за 24 години
Жорсткі ліміти доступні в кінцевій точці [/api/v3/exchangeInfo] .
Ліміти машинного навчання
Торгова поведінка оцінюється відносно середньостатистичного користувача. У разі дуже сильних відхилень, ви будете заблоковані на конкретний термін: від 5 хвилин до 3 днів.
Припустимо, що ваш показник свідчить про порушення у торгівлі. Показник виросте в разі:
- Ви неодноразово "випереджаєте" найкращі ордери бід/аск у книзі ордерів.
- Ви масово створюєте ордери й дуже швидко їх скасовуєте без виконання.
- Ваш "рівень конверсії" низький. "Рівень конверсії" – це співвідношення кількості угод до загальної кількості створених і скасованих ордерів за 24 години (кількість угод / [ордери + скасування]).
- Ваша "вага" низька. "Вага" – це співвідношення загальної кількості активів в угодах до загальної кількості створених і скасованих ордерів за 24 години (загальна кількість активів в угодах / [ордери + скасування]).
- При торгівлі парами, у яких BNB є базовим або котируваним активом, ваш показник зловживання буде посилений.
Ми не зможемо надати більш детальну інформацію, ніж представлена вище. Користувачам пропонується розробити свою ідеальну торгову систему експериментальним шляхом або обговорити оптимальну поведінку з іншими користувачами API.
Ліміти WAF (Файрвол вебзастосунків)
Ми не надаємо точних відомостей про наші правила WAF, але якщо ви зіткнулися з помилкою HTTP 403, значить, ви порушили правило. Швидше за все, це пов’язано з надмірною кількістю запитів протягом 5 хвилин. Однак, якщо ви відправляєте запит, який може бути сприйнятий як зловмисний, це також може привести до більш тривалого блокування.
Якщо я перевищу ліміт, чи буде обмежений мій акаунт, API-ключ або IP-адреса?
У разі жорстких лімітів, перевищення хвилинного ліміту сукупної ваги запитів (наразі 6000) призведе до блокування IP. Ліміти ордерів (зараз це 50 раз/10 секунд і 160 000 раз/24 години) будуть залежати від акаунту. Якщо ліміт ордерів був перевищений, вам також буде заборонено створювати нові ордери на сайті (або в інших застосунках).
У разі лімітів машинного навчання, до акаунтів будуть застосовуватися обмеження. Якщо ви отримали обмеження системою машинного навчання, ви можете дізнатися причину й тривалість через кінцеву точку [/sapi/v1/account/status] (зазначену в API документації).
Обмеження файрвола веб-додатків будуть застосовуватися тільки по IP. Зазвичай блокування WAF тривати 5 хвилин. Однак, якщо сервер визначить запит користувача як шкідливий, тривалість може збільшитися.
Я був обмежений за перевищення лімітів, але я виправив свій код. Чи знімуть блокування раніше?
Ні. Ви повинні дочекатися закінчення блокування.
Чому я отримав помилку HTTP 403 при використанні API?
Ви порушили правила WAF (файрвола веб-додатків), швидше за все, порушивши обмеження швидкості або відправивши шкідливий запит (як описано у розділі лімітів в цьому документі). Зазвичай тривалість подібного блокування становить 5 хвилин.
Чому мої WebSocket з'єднання скидаються/відключаються?
Активні з'єднання через WebSocket отримують пінг кожні 3 хвилини. Якщо ви не відповідатимете з правильно сформульованим пінгом, ваше з'єднання буде розірвано.
У разі потоків даних користувача, якщо повідомлення про активне з’єднання не буде отримано хоча б раз в 60 хвилин, термін дії listen key закінчується. Ви зможете знайти докладний опис в API документації.
Я використовую сторонній сервіс/wrapper, і він не працює. Ви можете допомогти?
На жаль, ми не підтримуємо сторонні сервіси або інструменти. Будь ласка, зверніться в компанію і/або до розробників, щоб отримати допомогу.
Крім того, вводити ваші API-ключі Binance і/або секретні ключі на будь-який сторонній платформі небезпечно. Будь ласка, використовуйте ці сервіси на власний розсуд.
Також звертаємо вашу увагу на те, що ми не надаємо загальну підтримку при програмуванні.
Я не робив жодних змін, але раптово став отримувати повідомлення про помилки. Що сталося?
На жаль, ми не можемо надати підтримку з питань, пов'язаних з вашим особистим проєктом. Якщо ви використовуєте сторонній wrapper/інструмент, будь ласка, зверніться за допомогою до служби підтримки/команди розробників.
Мені потрібен доступ до секретного ключа, але на екрані відображається лише "***". Як мені його отримати?
З міркувань безпеки й відповідно до розробки, секретні ключі доступні тільки під час створення API-ключа. Після цього, ключ завжди буде прихований. Якщо ви втратили його або не зафіксували, вам доведеться створити новий API-ключ і використовувати його з новим секретним ключем.
Чи можу я збільшити свої ліміти або виділений потік/пропускну здатність?
На жаль, наразі, ми не пропонуємо подібну послугу. Під час роботи не повинні виникати пробеми через ці обмеження.
Мій API-ключ зник.
Існують лише два можливих пояснення для "зникнення" API-ключа:
- Якщо ви були неактивні останнім часом і використовували API до 7 березня 2018 року, можливо, ваші API-ключі були видалені для забезпечення безпеки вашого акаунту.
- Якщо ж ви вирішили вимкнути свій акаунт, це призведе до видалення всіх без винятку активних API-ключів.
Ви зможете безперешкодно створити нові API-ключі.
Я отримую "Помилку -1021 (повідомлення: Відмітка часу для цього запиту знаходиться за межами recvWindow)". Як мені її вирішити?
Як правило, ця помилка виникає лише в тому випадку, якщо час сервера й системний час не синхронізуються. Можливо, вам буде потрібно синхронізувати системний годинник. Цей процес залежить від операційної системи.
Для Windows, ви на власний розсуд можете скористатися інструментом на зразок Atomic Clock. Користувачі Linux і Mac можуть спробувати зробити синхронізацію через "ntpdate" в командному рядку.
Якщо проблема не зникає, можливо, вона пов’язана із затримкою (проблема з мережею). Спробуйте налаштувати recvWindow.
Чи можу я отримати доступ до нових функцій API?
Якщо ви не бачите потрібних функцій у нашій документації, то ми скоріше не підтримуємо їх. Якщо ви бажаєте запропонувати нову функцію, ви можете звернутися до служби підтримки зі своєю пропозицією, і ми розглянемо її.
Я вважаю, що в роботі API є проблема. Як повідомити про неї?
Якщо ви вважаєте, що проблема пов’язана з системою, а не з її використанням вами, надайте докази на підтвердження своєї заяви, зв’язавшись з нами через форум розробників, і ми проведемо розслідування. Будь ласка, зверніть увагу, що ми не приймаємо повідомлення без чітких пояснень як належно оформлену скаргу.
Останнє оновлення: 24 жовтня 2023 р.