Подключение API-ключей Binance

API-ключ Binance позволяет торговать реальными деньгами прямо из терминала ProCluster: открывать сделки, ставить стоп и тейки, видеть баланс и позиции. Торговля идёт на фьючерсах USDT-M.

Главное правило

Никогда не разрешайте ключу вывод средств. Ключ с правом на вывод ProCluster не примет: права проверяются у Binance до сохранения. А если вывод включат позже, торговля остановится — права ключа проверяются перед каждой заявкой.

Что нужно заранее

1. Тариф с торговлей реальными деньгами. Раздел ключей открывается не на всех тарифах. Если в профиле написано «В ваш тариф этот раздел не входит», сравните тарифы на сайте ProCluster (кнопка Тарифы вверху) или в терминале: Профиль → вкладка Тарифы.
2. Двухфакторная защита в ProCluster. Без неё ключ не привязать. Как включить — в статье Двухфакторная защита.
3. Аккаунт Binance с открытым фьючерсным счётом (USDT-M).

Шаг 1. Откройте форму в ProCluster

1. Откройте Профиль → вкладка API ключи → раздел Биржевые ключи.

2. Нажмите Привязать ключ.

3. В вопросе Откуда этот ключ? выберите Создан в кабинете Binance.

Форму пока не закрывайте: в ней показаны IP-адреса нашего сервера — они понадобятся на следующем шаге.

Шаг 2. Создайте ключ на Binance

1. На Binance откройте Управление API (API Management) в настройках аккаунта и нажмите Создать API.

2. Выберите тип ключа System generated (создаётся системой), задайте название и пройдите проверку безопасности Binance.

3. Binance покажет API Key и Secret Key. Скопируйте оба и сохраните.

Осторожно

Secret Key Binance показывает один раз — при создании. Потеряли его — создайте новый ключ.

Названия пунктов на Binance иногда меняются — ориентируйтесь по смыслу.

Шаг 3. Настройте права ключа

Откройте у созданного ключа Изменить ограничения (Edit restrictions) и выставьте права так:

Право	Как поставить
Чтение (Enable Reading)	включено
Фьючерсы (Enable Futures)	включено
Вывод средств (Withdrawals)	выключено — всегда
Спот и маржа (Spot & Margin Trading)	выключено
Переводы (Universal Transfer)	выключено
Все остальные права	выключено

ProCluster проверяет права ключа у Binance. Ключ с лишними правами из кабинета Binance не привяжется — появится ошибка «У ключа лишние права».

Шаг 4. Заполните белый список IP

Белый список IP — это список адресов, с которых Binance разрешает пользоваться ключом. Без него Binance не даст ключу права на торговлю, а ProCluster такой ключ не примет.

1. В форме ProCluster нажмите Скопировать все адреса — скопируются все адреса нашего сервера сразу.

2. В настройках ключа на Binance выберите доступ только с доверенных IP (Restrict access to trusted IPs only).

3. Вставьте все скопированные адреса и сохраните.

Нужны ВСЕ адреса до одного

Заявки уходят с адресов нашего сервера по очереди. Если внести только часть, ключ будет отказывать через раз. Сами адреса здесь не приводятся — берите их только из формы в терминале, там всегда актуальный список.

Заметка

С любого другого адреса Binance этот ключ не пустит. Хотите следить за позициями в другом терминале или торговать там — создайте для этого отдельный ключ со своим белым списком.

Шаг 5. Включите односторонний режим позиций

ProCluster работает только в одностороннем режиме позиций (One-way). Режим хеджирования (Hedge Mode) не поддерживается: ключ привяжется и счёт будет виден, но торговля работать не будет.

1. Откройте фьючерсы USDT-M на Binance.

2. В настройках фьючерсов найдите Режим позиций (Position Mode).

3. Выберите Односторонний режим (One-way Mode) и подтвердите.

Binance разрешает сменить режим, только когда нет открытых позиций и заявок. Сначала закройте их.

Шаг 6. Привяжите ключ в ProCluster

1. Вернитесь в форму привязки в терминале.

2. Заполните поля:

   • Название — любое, чтобы отличать ключи (можно оставить пустым);
   • Ключ (API Key);
   • Секрет (Secret Key).

3. Введите код двухфакторной защиты из приложения на телефоне.

4. Нажмите Привязать.

Ключ и секрет хранятся у нас в зашифрованном виде и обратно не показываются никому — ни вам, ни кому-либо ещё.

Как понять, что всё подключилось

• Появилось сообщение Ключ привязан, а ключ — в списке раздела Биржевые ключи. Видны только первые и последние 4 символа и права, которые сообщила Binance: например, «фьючерсы» и «IP ограничен».
• В торговой панели терминала выберите счёт (Выбрать счёт) — Реальный. Сначала появится «Загружаю данные счёта с биржи…», затем Баланс, Позиции и Ордера.
• Если счёт в режиме хеджирования, на панели будет плашка Счёт в режиме хеджирования — вернитесь к шагу 5.

Привязать можно до двух ключей. Счётчик над кнопкой: Привязано ключей: N из M.

Как отвязать ключ

Нажмите Отвязать у ключа и подтвердите кодом двухфакторной защиты. Ключ удалится у нас, а на Binance останется — при желании привяжете его снова или удалите там сами.

Ключ из кабинета брокера

Если вы торгуете на Binance через брокера (например, Tiger), ключ Binance создаётся в кабинете брокера. В форме выберите Выдан кабинетом брокера и следуйте подсказкам в форме:

• нужен именно ключ Binance, созданный в кабинете брокера, с включённой торговлей;
• адреса нашего сервера вписываются в поле «белый список IP» в той же форме создания ключа;
• вывод средств не включайте.

У брокера одна галочка «торговля» включает спот и фьючерсы разом — такой ключ ProCluster примет.

Осторожно

Ключи TigerX не поддерживаются: это не биржевые ключи, Binance их не узнаёт, и привязка не пройдёт.

На некоторых тарифах реальная торговля возможна только ключом из кабинета брокера — тогда форма прямо об этом напишет.

Частые ошибки

Тексты ошибок — ровно как в терминале.

«Сначала включите двухфакторную аутентификацию.» — включите двухфакторную защиту и повторите.

«У этого ключа разрешён вывод средств — такой ключ мы не храним.» — выключите вывод в настройках ключа на Binance и привяжите заново.

«У ключа нет прав на фьючерсы.» — включите фьючерсы в настройках ключа на Binance.

«У ключа лишние права.» — для ключа из кабинета Binance оставьте только чтение и фьючерсы. Ключ от брокера привязывайте вариантом Выдан кабинетом брокера.

«У ключа не задан белый список адресов.» — внесите все адреса нашего сервера (шаг 4).

«Биржа не приняла ключ с этих адресов: …» — в белом списке не хватает адресов, которые перечислены в ошибке. Добавьте их — нужны все. Если все уже внесены, проверьте, что ключ и секрет скопированы целиком.

«Binance не узнала этот ключ, поэтому он не сохранён.» — проверьте, что ключ и секрет не перепутаны местами и скопированы целиком. Ключ TigerX не подойдёт.

«Не удалось спросить у Binance права ключа…» — проверьте, что ключу разрешено чтение, и попробуйте ещё раз.

«Неверный код подтверждения.» — введите свежий код из приложения.

«Больше двух ключей привязать нельзя. Отвяжите лишний.» — отвяжите ключ, который не нужен.

«Слишком много попыток. Подождите и попробуйте снова.» — подождите немного.

«Счёт в режиме хеджирования» — переключите Binance в односторонний режим (шаг 5).

«Binance отклонила этот ключ…» (в торговой панели) — ключ перестал работать: проверьте права и белый список, затем привяжите ключ заново.

«Нет связи с биржей» или «Связь с биржей потеряна» — терминал временно не достучался до Binance и продолжает пробовать сам. Цифры вернутся, когда связь восстановится.