Чтобы создать API-ключ Binance для фьючерсного торгового бота, сначала откройте фьючерсный счёт Binance, затем зайдите в API Management («Управление API»), создайте системный (System-generated) ключ, отметьте Enable Futures, оставьте Enable Withdrawals выключенным и ограничьте ключ IP-адресом сервера бота. Сразу скопируйте секретный ключ, а ключ и секрет вставляйте только на собственном сайте бота — никогда в чат.
Ниже — каждый шаг так, как его сегодня описывает справочный центр самой Binance, затем куда вводить ключ для HafizeBot и что делать, если Binance его отклоняет. Binance время от времени переименовывает пункты меню; если надпись на вашем экране отличается, ищите ближайшую по смыслу.
Что такое API-ключ Binance и чем он не является
API-ключ — это пара строк, которая позволяет программе действовать на вашем счёте Binance без вашего пароля. API-ключ (API key) говорит, какой ключ обращается к бирже; секретный ключ (secret key) подписывает каждый запрос, чтобы Binance знала, что он действительно от вас. Вместе они работают как логин для программы, ограниченный разрешениями, которые вы отметили.
Это не ваш пароль, и он не перемещает ваши средства: деньги остаются на ваших собственных кошельках Binance, а ключ позволяет только то, что вы включили. Поэтому важнее всего разрешения и ограничение по IP, о которых речь ниже.
Создание ключа по шагам ниже ничего не стоит. Бот обходится вам в торговые комиссии с ордеров, которые он выставляет, плюс стоимость его собственного тарифа.
Прежде чем начать: что Binance требует сначала
В статье Binance о создании API-ключей названы три условия, без которых кнопка Create API («Создать API») у вас не заработает:
- Двухфакторная аутентификация (2FA) включена на аккаунте.
- Верификация личности пройдена.
- Депозит любой суммы на спотовый кошелёк, который, по словам Binance, активирует аккаунт.
Для фьючерсного бота есть четвёртый шаг, и его место в очереди важно. Binance пишет, что ключ не может получить разрешение на фьючерсы, если он создан до открытия фьючерсного счёта. Поэтому сначала откройте Futures, а ключ сделайте потом. Если вы уже сделали наоборот, удалите ключ и создайте новый.
Ещё Binance пишет, что разрешение на фьючерсы нельзя включить, пока на аккаунте активен Portfolio Margin. Если вы им пользуетесь, разберитесь с этим на Binance до начала.
Как открыть фьючерсный счёт Binance
Справочная статья Binance «How to Open a Binance Futures Account?» («Как открыть фьючерсный счёт Binance?») описывает это так:
- Выберите Futures в меню на главной странице Binance и войдите в аккаунт.
- Нажмите Open Account («Открыть счёт»).
- Во всплывающем окне укажите свой уровень опыта в трейдинге. По нему Binance выставляет плечо по умолчанию (в её статье это 2x для новичков, 5x для опытных и 20x для продвинутых).
- Примите Binance Futures Service Agreement & Risk Acknowledgment (соглашение об услугах и уведомление о рисках), затем нажмите Open Now.
Binance добавляет, что торговать на Binance Futures можно только после верификации личности, а для первой сделки счёт нужно пополнить. О пополнении — ниже.
Как создать API-ключ на сайте Binance
Когда Futures открыт, сам ключ займёт пару минут. На сайте шаги Binance такие:
- Нажмите на значок профиля и откройте Account («Аккаунт»).
- Откройте API Management и нажмите Create API.
- Выберите тип ключа: для бота вроде нашего — System-generated (о двух типах — ниже).
- Введите название. Назовите ключ по имени бота, например «HafizeBot», чтобы всегда понимать, какой ключ какому сервису принадлежит.
- Подтвердите действие через 2FA или passkey.
Ключ создан, и Binance показывает API-ключ и секретный ключ. Скопируйте секрет в менеджер паролей или сразу на страницу ключей бота. Рассчитывайте, что больше его не увидите: если секрет потерян, решение — удалить ключ и создать новый, а не восстанавливать старый.
Системный или самостоятельно созданный? Системный (HMAC) ключ целиком создаёт Binance. Самостоятельно созданный (Ed25519 или RSA) — это пара ключей, которую вы генерируете сами и отдаёте Binance только публичную половину; используйте его, только если бот прямо его требует. Страница ключей HafizeBot запрашивает системный ключ и его секрет.
Где API-ключ в приложении Binance?
В приложении Binance, по инструкции самой биржи, нужно переключиться на версию Binance Pro, нажать More («Ещё»), чтобы открыть панель сервисов, пролистать до раздела Other («Другое») и нажать API Management. Дальше Create API, тип ключа, название и проверка 2FA — те же, что на сайте.
Если меню переехало, введите «API Management» в поиск приложения.
Какие разрешения отмечать: только Reading и Futures
Новый ключ создаётся с разрешением Enable Reading («Чтение»): бот видит балансы и позиции. Фьючерсному боту нужна ровно ещё одна галочка — Enable Futures («Фьючерсы»). И больше ничего.
- Enable Withdrawals (вывод средств): никогда. Ни одному торговому боту он не нужен. HafizeBot никогда его не запрашивает, а если вы сохраните ключ с включённым выводом, и страница ключей, и бот предупредят вас, что его нужно выключить. Ключ, который не может выводить, не отправит ваши деньги никуда, даже если утечёт.
- Enable Spot & Margin Trading (спот и маржинальная торговля): не нужно. Наш бот торгует только фьючерсами USDⓈ-M, так что разрешение на спотовую торговлю добавляет риск и не даёт никакой функции.
- Остальные разрешения: оставьте выключенными. Если вы не понимаете, зачем боту какая-то галочка, она ему не нужна.
Чтобы позже поменять разрешения, отредактируйте ограничения ключа в API Management и сохраните.
Привяжите ключ к одному IP-адресу
В настройках доступа ключа по IP выберите Restrict access to trusted IPs only («Доступ только с доверенных IP») и добавьте IP-адрес, с которого торгует ваш бот. Ключ с ограничением работает только с этого сервера, так что ключ, утёкший через скриншот, фишинговую страницу или заражённый ноутбук, бесполезен для того, кто его заполучил.
Для системного фьючерсного ключа это на практике не опция. В статье Binance сказано, что с 30 января 2023 года системному ключу без ограничения по IP можно включить только Enable Reading и что у HMAC-ключей без ограничения нет никаких разрешений, кроме чтения. Альтернативы, которые она предлагает, — самостоятельно созданный ключ или отключение стандартных защитных механизмов Binance; для торгового ключа мы бы второе делать не стали.
IP HafizeBot — 91.99.78.29. Это сервер, с которого уходит каждый запрос нашего бота к Binance; адрес опубликован на нашей пошаговой справочной странице о подключении ключа и на самой странице ключей. Добавьте ровно этот адрес и ничего больше. Ключ, привязанный к другому IP или к адресу с опечаткой, Binance отклоняет при каждом запросе.
Включите однонаправленный режим и пополните фьючерсный кошелёк USDⓈ-M
Две настройки Binance вне самого ключа решают, пройдёт ли первый ордер.
Режим позиций. HafizeBot торгует в однонаправленном режиме (One-way) Binance: одна позиция на монету, лонг или шорт. В режиме хеджирования Binance отклоняет ордера бота с ошибкой -4061. Чтобы переключиться, откройте торговый экран фьючерсов USDⓈ-M, нажмите значок настроек справа вверху, затем Preference → Position Mode → One-way. Binance позволяет сменить режим только без открытых ордеров и позиций. Подробности, в том числе как торговать хеджем вручную на субаккаунте, — на нашей справочной странице об однонаправленном режиме.
Фьючерсный кошелёк. Балансы Spot, Funding и Earn для фьючерсов не считаются. На экране фьючерсов найдите панель Assets («Активы»), нажмите Transfer («Перевод») и переведите USDT на кошелёк USDⓈ-M Futures. Binance отмечает, что у фьючерсов USDⓈ-M и COIN-M раздельные кошельки, так что проверьте, на какой переводите.
Сколько переводить, зависит от ваших настроек. Каждая сделка использует размер позиции как маржу:
При марже по умолчанию 5 USDT на сделку и лимите по умолчанию в 3 позиций полностью загруженный счёт держит 15 USDT, а каждый повторный вход по монете, которая у вас уже есть, добавляет ещё 5. Когда кошельку не хватает средств, Binance отклоняет следующий ордер с сообщением «Margin is insufficient» (ошибка -2019). Как устроены маржа и плечо, простыми словами объяснено в нашем руководстве по фьючерсной торговле криптой для новичков.
Куда вводить ключ для HafizeBot
Ключи для HafizeBot вводятся в одном месте: hafizebot.com/app/keys, после входа через Telegram. Мы никогда не просим ключ или секрет в чате Telegram, по почте или через форму, и тот, кто просит, — не мы. В старых версиях этой страницы описывалась форма; такого способа больше нет.
Полная настройка от начала до конца — десять шагов:
- На Binance: включите 2FA, пройдите верификацию личности и сделайте небольшой депозит на спот.
- На Binance: откройте фьючерсный счёт.
- На Binance: переведите USDT на кошелёк USDⓈ-M Futures.
- На Binance: переключите режим позиций на однонаправленный.
- На Binance: создайте системный ключ с названием бота.
- На Binance: отметьте Enable Futures и оставьте Enable Withdrawals выключенным.
- На Binance: привяжите ключ к 91.99.78.29.
- В Telegram: отправьте
/autotradeв @hafizebot. Для активного VIP-участника автоторговля включается сразу. - На сайте: откройте hafizebot.com/app/login, нажмите Log in with Telegram, перейдите на страницу ключей и вставьте ключ и секрет.
- В Telegram: проверьте свои лимиты через
/settingsили/summary, затем отправьте/on.
При сохранении секрет шифруется до записи в базу и больше никогда не показывается; страница лишь подтверждает, что ключ задан, и показывает его последние четыре символа. Сохранение ключа само по себе торговлю не запускает. Для этого и нужен /on.
Если сохранённый ключ может выводить средства, открыт для любого IP или не имеет Enable Futures, страница ключей всё равно его сохранит и подскажет, что из трёх нужно исправить на Binance.
Что проверяет /on, прежде чем бот начнёт торговать
Когда вы отправляете /on, бот один раз спрашивает Binance о сохранённом ключе, прежде чем включить автоторговлю:
- Работает ли ключ вообще? Если Binance его отклоняет (например, с ошибкой -2015), автоторговля остаётся выключенной, а бот сообщает код и его обычную причину.
- Отмечен ли Enable Futures? Если ключ может читать счёт, но не может торговать фьючерсами, автоторговля остаётся выключенной: каждый ордер всё равно был бы отклонён.
- Есть ли о чём предупредить? Ключ, который может выводить средства или открыт для любого IP, получает предупреждение в ответе.
Если в этот момент Binance недоступна, бот включается и сообщает, что ключ не проверен, — чтобы сбой на бирже никого не оставлял выключенным. Если ключ ещё не сохранён, /on сообщает, что торговать нечем, пока вы его не добавите.
/on не проверяет режим позиций и баланс фьючерсного кошелька. Это проявится на первом ордере, а /lastsignals затем покажет причину по каждому сигналу, который бот взял или пропустил.
Как изменить, заменить или отозвать ключ
- Отозвать на Binance: откройте API Management и удалите ключ. С этого момента Binance его отклоняет, и торговать с ним больше ничего не может. Ничьё разрешение для этого не нужно.
- Удалить из HafizeBot: на странице ключей выберите Delete key и подтвердите. Сначала выключается автоторговля, затем ключ и секрет стираются. Позиции и ордера, уже открытые на Binance, остаются открытыми; управляйте ими там. Тейк-профит и стоп, которые Binance уже держит, продолжают работать и без бота, поэтому стоп лучше задать заранее; как выбрать его дистанцию, разобрано в руководстве о том, как поставить стоп-лосс в крипте.
- Заменить: создайте новый ключ тем же способом, сохраните его на странице ключей (он заменит старый), затем удалите старый ключ на Binance.
- Если вы по ошибке вставили ключ в чат или что-то на аккаунте выглядит не так, удалите ключ на Binance и создайте новый. Не ждите, чтобы выяснить, было ли это важно.
Один ключ на бота означает, что вы можете отключить один сервис, не ломая остальные. Что мог бы сделать зловредный бот на каждом уровне разрешений, разобрано в нашем руководстве по безопасному подключению бота к Binance по API.
Частые ошибки после создания ключа
Большинство проблем первого часа — это одна пропущенная галочка или один неверный символ, и код ошибки Binance подсказывает, что именно:
Чаще всего встречается -2015, «Invalid API-key, IP, or permissions for action»: обычно не отмечен Enable Futures, ограничение по IP не совпадает в точности с IP бота или ключ создан раньше фьючерсного счёта. Пройтись по настройке ключа шаг за шагом поможет наша справочная страница о подключении ключа. Коды -2014 и -1022 обычно означают, что ключ или секрет вставлен с пропущенным или лишним символом.
Когда Binance отклоняет ключ или ордер из-за маржи, HafizeBot выключает автоторговлю и объясняет почему, а не повторяет ту же ошибку снова и снова. Исправив причину, отправьте /on.
Чего не скажет работающий ключ
Правильно созданный ключ — это безопасная часть. О том, хороши ли сигналы бота, он не говорит ничего. Результат каждого сигнала HafizeBot есть на живой странице результатов, включая промахи, а более сильные из них, силой 3 и выше, через 20 минут появляются в бесплатном Telegram-канале (VIP получает каждый сигнал сразу), так что за ними можно понаблюдать до оплаты и до подключения ключа. Сами сигналы генерирует ИИ — модель, которая оценивает 240+ индикаторов, формул и компонентов.
Автоторговля входит в каждый VIP-тариф; самый доступный, Tier 1, стоит 50 USDT в месяц, оплата в USDT командой /join в боте.
Часто задаваемые вопросы
API-ключ Binance бесплатный? Да. Binance не берёт плату за создание ключа в API Management. Вы платите обычные торговые комиссии Binance с ордеров, которые выставляются через ключ, плюс то, что берёт сам сервис бота.
Как получить фьючерсный API-ключ Binance? Отдельного фьючерсного ключа не существует. Сначала откройте фьючерсный счёт, затем создайте обычный ключ в API Management и отметьте у него Enable Futures. Ключ, созданный до открытия фьючерсного счёта, это разрешение получить не может, так что сделайте новый.
Почему у нового ключа можно отметить только Enable Reading? Потому что ключ не ограничен по IP. Binance пишет, что с 30 января 2023 года системному ключу без ограничения по IP доступно только Enable Reading. Добавьте IP бота в разделе Restrict access to trusted IPs only, и остальные галочки станут доступны.
Нужно ли включать вывод средств для торгового бота? Нет. Торговый бот выставляет ордера; выводить деньги с вашего счёта ему никогда не нужно. Оставьте Enable Withdrawals выключенным, чтобы утёкший ключ не мог никуда отправить ваши средства.
Куда вставлять API-ключ Binance для HafizeBot? Только на hafizebot.com/app/keys, после входа через Telegram. Никогда в чат Telegram и не по почте: мы никогда не просим ключ или секрет таким способом.
Что будет, если удалить API-ключ на Binance? С этого момента Binance его отклоняет, и бот больше не может выставлять или менять ордера. Уже открытые позиции остаются открытыми на вашем счёте вместе с теми тейк-профитами и стопами, которые Binance уже держит для них.
Коротко
Откройте Futures, затем создайте по одному системному ключу на каждого бота только с Reading и Futures, привяжите его к IP бота и вставляйте только на собственном сайте бота. Enable Withdrawals держите выключенным навсегда. Хороший ключ делает бота безопасным для подключения, но не делает его прибыльным: фьючерсная торговля с плечом может быстро приводить к потерям, и ничто из этого не является инвестиционной рекомендацией. Торгуйте только той суммой, потерю которой можете себе позволить, и проверьте статистику результатов, прежде чем что-либо подключать.