API-ключ
Время чтения: 5 минут.
Сначала: Биржа и ваш счёт.
Что такое ключ
API — способ, которым программа разговаривает с биржей. API-ключ — пропуск для программы. С ним стратегия действует на вашем счёте без вашего пароля от биржи.
На Binance, BingX и Bybit ключ состоит из двух частей:
- API Key — имя пропуска, его видно в настройках биржи;
- Secret Key — секрет, как пароль. Кто знает обе части, тот действует от вашего имени.
У Coinbase и Т Инвестиций ключ устроен иначе — см. Ключи на стороне биржи.
Права ключа
При создании ключа вы выбираете, что ему разрешено.
| Право | Что даёт | Стратегии нужно? |
|---|---|---|
| Чтение | Видеть балансы, заявки и сделки | Да |
| Торговля (спот или фьючерсы) | Ставить и снимать заявки | Да |
| Вывод средств | Переводить деньги с биржи наружу | Никогда |
Зачем запрещать вывод? Если ключ украдут, без права вывода деньги с биржи не увести.
Приложение проверяет ключ у самой биржи. Ключ с правом вывода оно не принимает: «Вывод средств разрешён — такой ключ не принимается». Раз в сутки сервис проверяет ключи снова. Если вывод у ключа включили позже, придёт сообщение «🔴 Ключ … включён вывод средств».
Список IP
IP-адрес — адрес компьютера в интернете. В настройках ключа можно задать список адресов, с которых биржа его примет. Впишите туда только адрес сервера Alphafamilia Algo.
Зачем это нужно:
- Защита. Украденный ключ с чужого адреса не сработает. Даже без вывода чужак мог бы торговать вам во вред.
- Binance. Ключ без списка IP там может только читать. Торговать стратегия не сможет.
- Bybit. Ключ без списка IP работает только 90 дней.
Адрес сервера приложение показывает при добавлении подключения, на шаге «2 · Ключ и проверка», с кнопкой «Копировать». Ключ без списка IP приложение принимает, но предупреждает.
Как создать ключ
- Включите двухфакторную защиту на бирже. Без неё биржа не даст создать ключ. Что это такое — урок Безопасность.
- Откройте на бирже управление ключами (API Management) и создайте ключ.
- Подтвердите создание кодом двухфакторной защиты.
- Скопируйте Secret Key сразу. Биржа показывает его один раз. Потеряли — удалите ключ и создайте новый.
- Включите торговлю, оставьте вывод выключенным, впишите адрес сервера в список IP.
- Введите ключ в форму приложения и нажмите «Проверить ключ».
Пошагово для каждой биржи — Ключи на стороне биржи.
Важно. Ключ и секрет вводите только в форму приложения. Не пишите их в чат или письмо. Не пересылайте никому, даже администратору системы. Сервис никогда их не просит.
Сейф ключей
Ваши ключи хранятся на сервере в сейфе ключей — в зашифрованном виде. Сейф открывается паролем сейфа.
- Пароль сейфа придумываете вы, не короче 10 знаков. Это не пароль биржи — придумайте другой.
- Пароль нигде не хранится. Без него ключи не прочитать — ни администратору, ни разработчику.
- Пароль не восстанавливается. Сохраните его в менеджере паролей.
- Забыли пароль — нажмите «Я забыл пароль»: задаёте новый и вводите ключи заново. Стратегии и история сохраняются; работавшие стратегии останавливаются, пока вы не запустите их снова.
- Пока сейф закрыт, стратегии не торгуют. После перезагрузки сервера сейф нужно открыть своим паролем.
Подробно — Подключения и сейф.
Как это использует стратегия
Стратегия ставит и снимает заявки через ваш ключ. Ключ берётся из открытого сейфа. Вывести деньги стратегия не может: ключ с таким правом приложение не примет.
Проверьте себя
1. Какие права нужны ключу для стратегии?
Ответ
Верно: а) чтение и торговля
Стратегия смотрит баланс и заявки и торгует. Вывод ей не нужен, а ключ с выводом приложение не примет.
2. Зачем вписывать в ключ адрес сервера (список IP)?
Ответ
Верно: в) чтобы ключ не сработал с чужого адреса; на Binance без этого нет торговли
Список IP — защита украденного ключа. На Binance ключ без списка IP может только читать.
3. Вы создали ключ, но не скопировали Secret Key и закрыли окно. Что делать?
Ответ
Верно: в) удалить этот ключ и создать новый
Secret Key биржа показывает только один раз. Восстановить его нельзя — проще создать новый ключ.
4. Вы забыли пароль сейфа. Что верно?
Ответ
Верно: г) восстановить нельзя: задаёте новый пароль и вводите ключи заново
Пароль сейфа нигде не хранится. Кнопка «Я забыл пароль» создаёт сейф заново, ключи вводятся ещё раз; стратегии и история сохраняются.
Источники
- Binance: How to Create API Keys on Binance — двухфакторная защита обязательна; ключ без ограничения по IP может только читать.