Документація API丨Офіційні приклади API丨Неофіційні приклади API
Які ліміти?
Огляд
Існує три різних типи лімітів, кожен з яких може бути змінений у будь-який час:
- Жорсткі ліміти
- Ліміти ML (Машинного навчання)
- Ліміти WAF (Файрвол веб-додатків)
Жорсткі ліміти:
- 1 200 одиниць ваги запиту у хвилину (зверніть увагу, що цей показник не обов'язково відповідає 1 200 запитам)
- 50 ордерів за 10 секунд
- 160 000 ордерів за 24 години
Жорсткі ліміти доступні в кінцевій точці [/api/v3/exchangeInfo] .
Ліміти машинного навчання:
Торгова поведінка оцінюється до середньостатистичного користувача. У разі дуже сильних відхилень, ви будете заблоковані на конкретний термін: від 5 хвилин до 3 днів.
Припустимо, що ваш показник свідчить про порушення у торгівлі. Показник виросте в разі:
- Ви неодноразово "випереджаєте" найкращі бід/аск ордери у книзі ордерів.
- Ви масово створюєте ордери і дуже швидко їх скасовуєте без виконання.
- Ваш "рівень конверсії" низький. "Рівень конверсії" – це відношення кількості угод до загальної кількості створених і скасованих ордерів за 24 години (кількість угод / (ордери + скасування)).
- Ваша "вага" низька. "Вага" – це відношення загальної кількості активів в угодах до загальної кількості створених і скасованих ордерів за 24 години (загальна кількість активів в угодах / (ордери + скасування)).
- При торгівлі парами, у яких BNB є базовим або котируваним активом, ваш показник зловживання буде посилений.
Ми не зможемо надати більш детальну інформацію, ніж представлена вище. Користувачам пропонується розробити свою ідеальну торгову систему експериментальним шляхом або обговорити оптимальну поведінку з іншими користувачами API.
Ліміти WAF (Файрвол веб-додатків)
Ми не надаємо точних відомостей про наші правила WAF, але якщо ви зіткнулися з помилкою HTTP 403, значить, ви порушили правило. Швидше за все, це пов'язано з надмірною кількістю запитів протягом 5 хвилин. Однак, якщо ви відправляєте запит, який може бути сприйнятий як зловмисний, це також може привести до більш тривалого блокування.
Якщо я перевищу ліміт, чи буде обмежений мій акаунт, API-ключ або IP-адреса?
У разі жорстких лімітів, перевищення хвилинного ліміту сукупної ваги запитів (зараз 1 200) призведе до блокування 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-ключа:
1. Якщо ви були неактивні останнім часом і використовували API до 7 березня 2018 року, можливо, ваші API-ключі були видалені для забезпечення безпеки вашого акаунта.
2. Якщо ж ви вирішили вимкнути свій акаунт, це призведе до видалення всіх без винятку активних API-ключів.
Ви зможете безперешкодно створити нові API-ключі.
Я отримую "Помилку -1021 (повідомлення: Відмітка часу для цього запиту знаходиться за межами recvWindow)". Як мені її вирішити?
Зазвичай ця помилка виникає тільки в тому випадку, якщо є розсинхронізація між часом сервера і системним часом. Можливо, вам буде потрібно синхронізувати системний годинник. Цей процес залежить від операційної системи.
Для Windows, ви на власний розсуд можете скористатися інструментом на зразок Atomic Clock. Користувачі Linux і Mac можуть спробувати зробити синхронізацію через "ntpdate" в командному рядку.
Якщо проблема не зникає, це може бути пов'язано із затримкою (проблемою з мережею), і може знадобитися налаштувати recvWindow.
Чи можу я отримати доступ до нових функцій API?
Якщо ви не бачите потрібних функцій у нашій документації, то ми скоріше не підтримуємо їх. Якщо ви бажаєте запропонувати нову функцію, ви можете звернутися до служби підтримки зі своєю пропозицією, і ми розглянемо її.
Я вважаю, що в роботі API є проблема. Як повідомити про неї?
Якщо ви вважаєте, що проблема пов'язана з системою, а не з вашим діями, будь ласка, надайте докази на підтримку вашої претензії у нашому чаті щодо API в Telegram, і ми вирішимо проблему. Будь ласка, зверніть увагу, що ми не вважаємо непереконливі повідомлення повноцінними претензіями. Більш того, в цій групі не надають офіційної підтримки з програмуванню; це група спільноти користувачів Binance API.
Востаннє оновлено 16 травня 2022 року