Справка Alphafamilia Algo

Ключи на стороне биржи

Коротко

  • Ключ API создаёте вы в личном кабинете биржи, а вводите только в форму приложения.
  • Ключу нужно право торговли; ключ с правом вывода средств не примется.
  • Никому не пересылайте ключ и секрет — даже администратору системы.

Стратегия торгует на бирже через ключ API (на Binance, BingX и Bybit — API Key и Secret Key, у Coinbase — имя ключа и закрытый ключ, у Т Инвестиций — токен). Ключ создаёте вы, в личном кабинете биржи. Потом вы вводите его в приложении, и сервис сам спрашивает у биржи, что ключ умеет. Эта страница — о том, как подготовить ключ на бирже.

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

Binance

Какой нужен ключ

Настройка ключа на Binance Что нужно
Тип ключа System-generated (HMAC): биржа выдаёт API Key и Secret Key
Чтение (Enable Reading) Включено
Торговля на споте Включена — для стратегий на споте
Фьючерсы (Enable Futures) Включено — если нужны фьючерсные стратегии
Вывод средств (Withdrawals) Выключен
Ограничение доступа по IP Только адрес сервера Alphafamilia Algo

Приложение проверяет ключ у самой биржи (кнопка «Проверить ключ» при добавлении подключения) и показывает ответ по пунктам:

  • если вывод средств разрешён, ключ не принимается: «Вывод средств разрешён — такой ключ не принимается»;
  • если торговля не разрешена, ключ не принимается;
  • для подключения «Binance фьючерсы USD-M» ключу нужно право на фьючерсы («Enable Futures»), для «Binance спот» — на спот («Enable Spot & Margin Trading»); без него ключ не принимается;
  • если нет ограничения по IP, ключ принимается с предупреждением, и в нём приложение показывает адрес сервера. Но торговать Binance разрешает только ключу со списком IP: если списка нет и торговля не разрешена, «Результат проверки» пишет одну строку — «✗ Binance разрешает торговлю только ключу со списком IP. Добавьте адрес сервера … в список IP ключа («Restrict access to trusted IPs only»), включите «Enable Spot & Margin Trading» (для фьючерсов — «Enable Futures») и нажмите «Проверить ключ» снова.»

Один ключ может обслуживать и спот, и фьючерсы одного счёта, но в приложении это два подключения — «Binance спот» и «Binance фьючерсы USD-M»; ключ вводится для каждого. Для «Binance фьючерсы COIN-M» нужно то же право «Enable Futures» — у Binance оно одно на USD-M и COIN-M, поэтому подойдёт тот же ключ; его тоже вводят ещё раз, а проверка спрашивает счёт COIN-M (Хочу торговать фьючерсами COIN-M).

Создать ключ

  1. Узнайте адрес (IP) сервера: приложение показывает его в шаге 2 нового подключения («Профиль» → «Настройки» → «Подключения к биржам» → «+ Новое подключение»), с кнопкой «Копировать». Там же — памятка, что включить у ключа, и ссылка на эту инструкцию Binance.
  2. Откройте на Binance управление ключами API: профиль → «Account» → «API Management» → «Create API».
  3. Выберите тип ключа «System-generated» и введите название, например dca2.
  4. Подтвердите создание кодами двухфакторной защиты.
  5. Скопируйте API Key и Secret Key. Secret Key биржа показывает один раз.
  6. Откройте редактирование ключа и выберите ограничение доступа по IP: только доверенные адреса. Впишите адрес сервера.
  7. Включите торговлю на споте и, если нужны фьючерсы, «Enable Futures».
  8. Убедитесь, что вывод средств выключен.
  9. Сохраните настройки ключа и подтвердите их кодами защиты.

Официальная инструкция Binance (на английском): How to Create API Keys on Binance.

Важно. По правилам Binance ключ без ограничения по IP по умолчанию может только читать. Поэтому ограничение по адресу сервера нужно не только для защиты, но и для торговли.

Важно. Ключи с собственной парой (Ed25519, RSA) приложение не принимает: в форме нужны API Key и Secret Key по 64 латинские буквы и цифры. Ключ другого вида получит ответ «Ключ неверного вида (лишние пробелы?).».

Совет. Право на фьючерсы нельзя включить у ключа, созданного до открытия фьючерсного счёта. Если пункта нет, откройте фьючерсный счёт и создайте новый ключ.

Тестовая сеть Binance

Тестовая сеть — учебная биржа с ненастоящими деньгами. Ключ для неё создаётся отдельно, не в обычном кабинете Binance.

  1. Откройте сайт Spot Test Network: https://testnet.binance.vision.
  2. Войдите через GitHub.
  3. Нажмите «Generate HMAC_SHA256 Key» и сохраните API Key и Secret Key. Secret Key показывается один раз. Ограничения по IP-адресу этому ключу не нужны.
  4. В приложении при добавлении подключения выберите среду «тестовая сеть».

Тестовые деньги уже лежат на счёте тестовой сети — пополнять его не нужно. На экране подключения подсказка для тестовой сети короче, чем для реальной.

Официальная инструкция Binance: How to Test My Functions on Binance Testnet?.

В тестовой сети биржа не сообщает ограничения ключа. Поэтому там нет проверок вывода и IP-адреса.

Для учебной торговли фьючерсами у Binance демо-торговля и свои ключи: войдите своим аккаунтом Binance на https://demo.binance.com, откройте демо-торговлю фьючерсами и раздел «Управление API» (API Management, https://demo.binance.com/en/my/settings/api-management). Ключи, созданные раньше на старом учебном сайте testnet.binancefuture.com, тоже работают. Такой ключ тоже добавляется как подключение Binance со средой «тестовая сеть»: приложение проверит его на учебных фьючерсах. Торгует он только фьючерсами — спотовые стратегии на таком подключении работать не будут.

BingX

У BingX, как у Binance, ключ из двух частей — API Key и Secret Key. Права ключа — «Read» (включено всегда), «Spot Trading» для спота, «Perpetual Futures Trading» для фьючерсов; «Withdrawal» и переводы — выключены; в IP whitelist — адрес сервера. Фьючерсный ключ можно проверить на учебном счёте VST (виртуальные USDT); учебного спота у BingX нет.

Как создать ключ, что переключить на фьючерсном счёте и чем BingX отличается от Binance — BingX: спот и фьючерсы USDT-M. Страница ключей BingX: API Management.

Важно. Сервер ходит на BingX только по IPv4-адресу — именно его показывает приложение в шаге 2 нового подключения. Ключ, в списке IP которого нет адреса сервера, проверка отклонит с подсказкой добавить адрес.

Bybit

У Bybit ключ тоже из двух частей — API Key и Secret Key. Нужен ключ глобального bybit.com на едином торговом счёте (Unified Trading Account); ключ классического счёта не примется.

Настройка ключа на Bybit Что нужно
Тип ключа «System-generated», права «Read-Write»
Спот «Unified Trading» → «Trade» — для подключения «Bybit спот»
Фьючерсы «Contracts» → «Orders» и «Positions» — для подключения «Bybit фьючерсы USDT»
Вывод («Withdrawal» в «Assets») Выключен — ключ с правом вывода не примется
IP Адрес сервера. Ключ без списка IP Bybit отключает через 90 дней

Ключ без IP приложение принимает, но показывает его срок в карточке подключения и напоминает в Telegram за 7 дней и в день окончания. Демо-счёт Bybit — со своими ключами: на сайте bybit.com переключитесь в режим «Демо-торговля» (Demo Trading) и создайте ключ там; демо-средства запрашиваются там же. Как создать ключ, демо-счёт и настройки фьючерсного счёта — Bybit. Инструкция Bybit: How to create your API key.

Coinbase

У Coinbase ключ другого вида: его создают не в профиле, а на портале разработчиков CDP (portal.cdp.coinbase.com → API Keys → Secret API Keys), и состоит он из имени ключа (organizations/…/apiKeys/…) и закрытого ключа (текст с BEGIN и END).

Настройка ключа на Coinbase Что нужно
Алгоритм подписи ECDSA (Ed25519 не принимается)
Права «View» и «Trade»
«Transfer» (перевод и вывод) Выключен — ключ с этим правом не примется
Портфель Ключ ограничен портфелем для стратегий
IP allowlist Адрес сервера. Приложение список IP Coinbase не видит и не предупреждает

Закрытый ключ вставляют целиком — с переносами строк или без них, а файл ключа CDP можно вставить в любое из двух полей. У ключа нет срока действия. Как создать ключ, почему нет учебной среды и чем Coinbase отличается от Binance — Coinbase. Инструкция Coinbase: API Key Authentication.

Срок ключа и ежедневная проверка

Некоторые биржи ограничивают срок ключа (Bybit — 90 дней у ключа без списка IP). Если биржа сообщает срок, он хранится вместе с подключением и виден в его карточке: «Ключ действует до 30.01.2027 (89 дн.)». За 7 дней и в день окончания приходит напоминание в Telegram — тогда создайте на бирже новый ключ и замените его в приложении («Заменить ключ», стратегии подключения остановлены).

Раз в сутки сервер сам проверяет ключи всех ваших бирж — по одному, без лишней нагрузки, и не во время блокировки адреса сервера биржей. Если ответ биржи изменился, приходит сообщение: новый срок, срок появился или пропал, ключ больше не работает, у ключа включили вывод средств, у ключа нет права торговли. Все такие сообщения — Сообщения в Telegram.

BNB для комиссий (Binance). Та же ежедневная проверка смотрит, включена ли на Binance оплата комиссий в BNB. Если включена, а BNB сверх того, что стратегии считают своим, меньше 0,02 BNB или стоит меньше 12 USDT по цене BNB, приходит «мало BNB для комиссий» — раз в сутки, пока запас не пополнен. На споте BNB нужен на спотовом счёте, на фьючерсах — на фьючерсном кошельке (BNB туда надо перевести). Ничего не останавливается и не продаётся; когда запас кончится, биржа возьмёт комиссию с получаемой монеты (на фьючерсах — без скидки). Купите немного BNB или выключите оплату комиссий в BNB в настройках аккаунта на бирже. Если оплата в BNB выключена, комиссия покупки на споте берётся из купленной монеты, и стратегия покупает на шаг количества больше — чтобы после комиссии на ТП осталось плановое количество.

Т Инвестиции

Какой нужен токен

Т Инвестиции работают не с ключом и секретом, а с одним токеном. Токен начинается с t..

  • Для проверок — токен песочницы: деньги в ней не настоящие. Для среды «песочница» памятка в приложении своя: «Выпустите в Т Инвестициях токен для песочницы — не реальный.», «Нет счёта песочницы — после проверки токена откройте его кнопкой: приложение пополнит его на 100 000 виртуальных ₽.», «Ограничения по IP у токена нет.».
  • Для работы — токен с правом торговли. Лучше всего — с доступом только к одному счёту, который вы выделили для стратегий.

Токен не умеет выводить деньги, а ограничения по IP у брокера для токенов нет. Поэтому для токена приложение проверяет только счета и право торговли на них.

Создать токен

  1. Откройте приложение или сайт Т Инвестиций.
  2. Перейдите: Настройки → Токены T-Invest API → «Создать токен».
  3. Выберите вид токена: для песочницы или с правом торговли.
  4. Ограничьте доступ счётом для стратегий, если брокер предлагает выбор счёта.
  5. Скопируйте токен. Брокер показывает его один раз.

Официальное описание: Токен — T-Invest API, песочница — Песочница — T-Invest API.

Счёт для стратегий

В приложении после ввода токена нажмите «Проверить токен и показать счета» и выберите счёт. Счета, на которых токену можно только читать, отмечены «только чтение» и выбрать их нельзя. Подробно — Подключения и сейф.

Совет. У нового токена песочницы счетов нет. Проверка тогда пишет «Ключ не примется — У токена нет счёта песочницы. Откройте его кнопкой ниже.», а под ней — кнопка «Открыть счёт песочницы (с тестовым балансом 100 000 ₽)»: приложение откроет счёт у брокера, пополнит его на 100 000 виртуальных рублей и сразу покажет его для выбора. Если на счёте кончились деньги — попросите администратора системы пополнить его.

Особенности торговли акциями и фондами — Акции и фонды Т Инвестиций.

Дальше: Подключения и сейф