Как подключить ключ 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) создайте новый ключ, включите фьючерсы и выключите вывод. Секрет показывается один раз: сохраните его сразу.
Как заменить ключ на новый?
Просто подключите новый ключ в том же блоке: предыдущий сервис отзовёт сам. Кнопка «Отсоединить» же отключает всех ботов.
Можно ли подключить аккаунт, на котором я торгую вручную?
Технически можно, но лучше не стоит. Ручные сделки и другие боты делят с ботом одну маржу, а позицию, которую бот не открывал, он может принять за брошенную и поставить на неё аварийный стоп. Надёжнее завести отдельный аккаунт или субаккаунт только для бота.