Exchange
Блокчейн та біржа крипто-активів
Academy
Освіта у сфері блокчейна і криптовалют
Брокер
Рішення торгових терміналів
Charity
Благодійність
Cloud
Корпоративні біржові рішення
DEX
Швидка і безпечна децентралізована біржа цифрових активів
Labs
Інкубатор для кращих блокчейн-проектів
Launchpad
Платформа для випуску токенів
Research
Інституціональний рівень аналізів та звітів
Trust Wallet
Офіційний крипто-гаманець Binance
Купити криптовалюту
Ринки
Конвертація
Найпростіший спосіб торгівлі
Класична
Простий і зручний інтерфейс
Просунута
Повний доступ до всіх торгових інструментів
Маржа
Максимізуйте прибуток із високим кредитним плечем
P2P
Банківський переказ та 100+ варіантів
Фондовий токен
New
Торгуйте акціями за допомогою криптовалюти
Торгівля
NFT
Проскануйте, щоб завантажити додаток IOS або Android
Завантажити
English
USD
Центр підтримки
Посібник (FAQ)
API
Правила торгівлі по API
Поширені запитання по API (FAQ)
Binance
2018-06-05 09:38

API документаціяНеофіційні приклади використання API 

Які ліміти?

Огляд
Існує три різних типи лімітів, кожен з яких може бути змінений у будь-який час:
  1. Жорсткі ліміти
  2. Ліміти ML (Машинного навчання)
  3. Ліміти 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.
Статті по темі
Як створити API