Як підключити ключ Binance до бота
Оновлено:
Коротко про те, як підключити ключ Binance до бота: потрібно створити API-ключ на біржі з правом торгівлі на ф'ючерсах і без права виведення коштів, а потім вставити його в налаштуваннях сервісу. Без ключа боти нічого не роблять: торгувати їм нема чим. Усе займає кілька хвилин.
Що таке API-ключ і чому це безпечно, якщо зробити правильно
API-ключ це пара рядків: «API Key» (публічна частина) і «Secret» (секретна). Вони дають програмі змогу виставляти заявки від вашого імені, не знаючи пароля від акаунта. Права ключа ви задаєте самі. Сервіс перевіряє їх у Binance при підключенні й відмовляє, якщо ключ вміє виводити кошти. Тож навіть якщо ключ колись потрапить до чужих рук, вивести гроші з його допомогою буде неможливо.
Ключ зберігається в зашифрованому вигляді. Сервіс розшифровує його лише в процесі, який виставляє заявки.
Крок 1. Підготуйте ф'ючерсний рахунок
Переконайтеся, що в Binance відкрито рахунок USDT-M ф'ючерсів і на ньому є USDT, які ви готові використовувати. Без ф'ючерсного рахунку ключ не пройде перевірку.
Краще окремий акаунт або субакаунт
Найкраще підключати ключ від акаунта, на якому торгує лише бот: окремого акаунта Binance або субакаунта основного. Переказуйте туди тільки ту суму, яку готові довірити боту. Туди не повинно потрапляти нічого іншого: ні ручної торгівлі, ні інших ботів. Ось чому:
- Спільна маржа. На крос-маржі всі позиції акаунта ділять один баланс. Ручна угода чи інший бот можуть «з'їсти» маржу бота, а збиток бота зменшує запас ваших власних угод. Ліквідація тоді може настати раніше, ніж спрацює стоп.
- Бот не відрізнить чуже від свого. Після перезапуску сервіс звіряється з біржею. Позицію, якої немає в його списку, він вважає покинутою й може поставити на неї аварійний стоп, який закриє її, якщо ціна піде проти неї.
- Налаштування по монетах. Бот сам виставляє плече й режим маржі на монетах, де торгує. На біржі це діє на весь акаунт по цій монеті, зокрема й на ваші ручні позиції.
- Зрозумілий облік. Усі угоди й увесь баланс на такому акаунті належать боту, тому сторінку «Угоди» легко звірити з випискою Binance.
Як створити субакаунт, залежить від типу вашого акаунта на біржі: шукайте в Binance розділ керування субакаунтами й не забудьте ввімкнути для нього ф'ючерси.
Крок 2. Створіть ключ у Binance
- В акаунті Binance відкрийте керування API-ключами (розділ API Management).
- Створіть новий ключ і дайте йому впізнавану назву.
- Підтвердьте створення вимогами біржі (код із застосунку, пошта тощо).
- Збережіть «Secret» одразу: Binance показує його лише один раз.
Назви кнопок і розділів на біржі можуть змінюватись, тож орієнтуйтесь на сенс.
Крок 3. Виставте права
У налаштуваннях ключа (на Binance це «Edit restrictions»):
- «Enable Futures»: увімкнути. Без цього права сервіс скаже: «Ключ не має права торгувати ф'ючерсами».
- «Enable Withdrawals»: вимкнути. Якщо воно ввімкнене, сервіс відхилить ключ із повідомленням «Ключ має право на виведення коштів».
- Право торгувати на споті для роботи не потрібне.
- Обмеження за IP: в Binance це «Restrict access to trusted IPs only». Інтерфейс сервісу прямо радить додати IP сервера в allowlist, щоб викрадений ключ не працював з іншої машини. Це не обов'язково для підключення, але додає безпеки. Додавати треба адресу машини, з якої сервіс звертається до Binance. Якщо ви її не знаєте, ліпше залиште обмеження вимкненим, ніж вказати чужу адресу: ключ тоді не спрацює взагалі.
Крок 4. Вставте ключ у сервісі
- У меню відкрийте «Налаштування».
- Знайдіть блок «Ключ до Binance».
- У полі «API Key» вставте публічну частину ключа.
- У полі «Secret» вставте секрет.
- Натисніть «Перевірити й підключити».
Якщо все гаразд, у блоці з'явиться напис «Ключ підключено», назва ключа й час перевірки.
Що робить перевірка
Сервіс робить кілька запитів до Binance. Перший доводить, що ключ працює й ф'ючерси доступні, і перевіряє, що торгівля на акаунті не заборонена. Другий читає права самого ключа. Якщо відповіді не вдалось отримати, ключ не зберігається: без відповіді сервіс не може пообіцяти, що ключ без права виведення.
Якщо ключ не прийняли
| Повідомлення | Що робити |
|---|---|
| «Біржа не прийняла ключ» | Перевірте, що скопіювали ключ і секрет повністю, без пробілів, і що ключ не відкликано. Якщо ввімкнено обмеження за IP, перевірте, що в списку є адреса сервера. |
| «Біржа заборонила торгівлю на цьому акаунті» | Перевірте статус акаунта в Binance. |
| «Ключ має право на виведення коштів» | Вимкніть «Enable Withdrawals» у ключі й спробуйте ще раз. |
| «Ключ не має права торгувати ф'ючерсами» | Увімкніть «Enable Futures» у ключі. |
| «Не вдалося перевірити права ключа» | Це збій запиту до біржі: спробуйте за кілька хвилин. Ключ не збережено. |
Тестова біржа
Якщо сервіс працює в тестовому режимі, у формі з'являється галочка «це ключ від testnet». Для тестової біржі ключ беруть окремо на сторінці testnet.binancefuture.com; права там фіксовані й змінити їх не можна, виводити нема чого, тож описані вище три пункти (ф'ючерси, виведення, IP) для неї не потрібні. Галочка має відповідати режиму сервісу: інакше ключ збережеться, але кожна заявка буде відхилена. Сторінка «Боти» покаже попередження, якщо ключ не від тієї біржі, на якій працює сервіс.
Заміна й відключення
- Замінити ключ. Підключіть новий у тому ж блоці. Попередній буде відкликано автоматично.
- «Відʼєднати». Кнопка поруч із записом про ключ. Вона вимкне всіх ботів, бо без ключа вони торгувати не можуть. Позиції, що вже відкриті на біржі, нікуди не зникають: стежте за ними на Binance.
- Якщо ви підозрюєте витік, надійніше за все видалити ключ у самій Binance: тоді він перестане працювати негайно.
Що далі
Зазвичай наступні кроки такі: підключити Telegram, щоб отримувати повідомлення про угоди, і створити першого бота. Пам'ятайте, що торгівля ф'ючерсами з плечем ризикована й що ключ дає боту право відкривати угоди на вашому рахунку; про те, як це оцінювати тверезо, читайте в статті чи працюють торгові боти.
Часті питання
Які права треба дати API-ключу Binance для бота?
Потрібне право торгівлі на ф'ючерсах («Enable Futures»). Право виведення коштів («Enable Withdrawals») має бути вимкнене: ключ із таким правом сервіс не приймає.
Чому сервіс не приймає ключ з правом виведення?
Щоб навіть у разі витоку ключ не міг вивести ваші гроші. Тоді в найгіршому разі хтось зможе торгувати, але не забрати кошти.
Де взяти API-ключ у Binance?
В акаунті Binance в розділі керування API (API Management) створіть новий ключ, увімкніть ф'ючерси й вимкніть виведення. Секрет показується лише раз: збережіть його одразу.
Як замінити ключ на новий?
Просто підключіть новий ключ у тому ж блоці: попередній сервіс відкличе сам. Кнопка «Відʼєднати» натомість вимикає всіх ботів.
Чи можна підключити акаунт, на якому я торгую вручну?
Технічно можна, але краще не треба. Ручні угоди й інші боти ділять з ботом одну маржу, а позицію, якої бот не відкривав, він може сприйняти як покинуту й поставити на неї аварійний стоп. Надійніше завести окремий акаунт або субакаунт лише для бота.