Справка Alphafamilia Algo

API-ключ

Время чтения: 5 минут.

Сначала: Биржа и ваш счёт.

Что такое ключ

API — способ, которым программа разговаривает с биржей. API-ключ — пропуск для программы. С ним стратегия действует на вашем счёте без вашего пароля от биржи.

На Binance, BingX и Bybit ключ состоит из двух частей:

  • API Key — имя пропуска, его видно в настройках биржи;
  • Secret Key — секрет, как пароль. Кто знает обе части, тот действует от вашего имени.

У Coinbase и Т Инвестиций ключ устроен иначе — см. Ключи на стороне биржи.

Права ключа

При создании ключа вы выбираете, что ему разрешено.

Право Что даёт Стратегии нужно?
Чтение Видеть балансы, заявки и сделки Да
Торговля (спот или фьючерсы) Ставить и снимать заявки Да
Вывод средств Переводить деньги с биржи наружу Никогда

Зачем запрещать вывод? Если ключ украдут, без права вывода деньги с биржи не увести.

Приложение проверяет ключ у самой биржи. Ключ с правом вывода оно не принимает: «Вывод средств разрешён — такой ключ не принимается». Раз в сутки сервис проверяет ключи снова. Если вывод у ключа включили позже, придёт сообщение «🔴 Ключ … включён вывод средств».

Список IP

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

Зачем это нужно:

  • Защита. Украденный ключ с чужого адреса не сработает. Даже без вывода чужак мог бы торговать вам во вред.
  • Binance. Ключ без списка IP там может только читать. Торговать стратегия не сможет.
  • Bybit. Ключ без списка IP работает только 90 дней.

Адрес сервера приложение показывает при добавлении подключения, на шаге «2 · Ключ и проверка», с кнопкой «Копировать». Ключ без списка IP приложение принимает, но предупреждает.

Как создать ключ

  1. Включите двухфакторную защиту на бирже. Без неё биржа не даст создать ключ. Что это такое — урок Безопасность.
  2. Откройте на бирже управление ключами (API Management) и создайте ключ.
  3. Подтвердите создание кодом двухфакторной защиты.
  4. Скопируйте Secret Key сразу. Биржа показывает его один раз. Потеряли — удалите ключ и создайте новый.
  5. Включите торговлю, оставьте вывод выключенным, впишите адрес сервера в список IP.
  6. Введите ключ в форму приложения и нажмите «Проверить ключ».

Пошагово для каждой биржи — Ключи на стороне биржи.

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

Сейф ключей

Ваши ключи хранятся на сервере в сейфе ключей — в зашифрованном виде. Сейф открывается паролем сейфа.

  • Пароль сейфа придумываете вы, не короче 10 знаков. Это не пароль биржи — придумайте другой.
  • Пароль нигде не хранится. Без него ключи не прочитать — ни администратору, ни разработчику.
  • Пароль не восстанавливается. Сохраните его в менеджере паролей.
  • Забыли пароль — нажмите «Я забыл пароль»: задаёте новый и вводите ключи заново. Стратегии и история сохраняются; работавшие стратегии останавливаются, пока вы не запустите их снова.
  • Пока сейф закрыт, стратегии не торгуют. После перезагрузки сервера сейф нужно открыть своим паролем.

Подробно — Подключения и сейф.

Как это использует стратегия

Стратегия ставит и снимает заявки через ваш ключ. Ключ берётся из открытого сейфа. Вывести деньги стратегия не может: ключ с таким правом приложение не примет.

Проверьте себя

1. Какие права нужны ключу для стратегии?

  1. а) чтение и торговля
  2. б) чтение, торговля и вывод средств
  3. в) только чтение
Ответ

Верно: а) чтение и торговля

Стратегия смотрит баланс и заявки и торгует. Вывод ей не нужен, а ключ с выводом приложение не примет.

2. Зачем вписывать в ключ адрес сервера (список IP)?

  1. а) чтобы стратегия работала быстрее
  2. б) чтобы биржа брала меньше комиссии
  3. в) чтобы ключ не сработал с чужого адреса; на Binance без этого нет торговли
Ответ

Верно: в) чтобы ключ не сработал с чужого адреса; на Binance без этого нет торговли

Список IP — защита украденного ключа. На Binance ключ без списка IP может только читать.

3. Вы создали ключ, но не скопировали Secret Key и закрыли окно. Что делать?

  1. а) попросить биржу показать Secret Key ещё раз
  2. б) попросить администратора системы прислать его
  3. в) удалить этот ключ и создать новый
Ответ

Верно: в) удалить этот ключ и создать новый

Secret Key биржа показывает только один раз. Восстановить его нельзя — проще создать новый ключ.

4. Вы забыли пароль сейфа. Что верно?

  1. а) его можно восстановить по почте
  2. б) это пароль биржи, его сбрасывают на бирже
  3. в) администратор подскажет его
  4. г) восстановить нельзя: задаёте новый пароль и вводите ключи заново
Ответ

Верно: г) восстановить нельзя: задаёте новый пароль и вводите ключи заново

Пароль сейфа нигде не хранится. Кнопка «Я забыл пароль» создаёт сейф заново, ключи вводятся ещё раз; стратегии и история сохраняются.

Источники

  • Binance: How to Create API Keys on Binance — двухфакторная защита обязательна; ключ без ограничения по IP может только читать.