Как подключить биржу к Freya Finance: разбираемся с API ключами
Прежде чем бот сможет торговать за вас, Freya нужно подключение к бирже, где хранятся ваши средства, — Binance, OKX или Bybit. Для этого вы не переводите деньги и не сообщаете свой пароль от биржи. Вместо этого вы создаёте API ключ: ограниченные учётные данные, которые позволяют Freya размещать сделки от вашего имени, тогда как деньги остаются на вашем собственном счёте на бирже.
Это руководство объясняет, какие именно разрешения нужно выдать (а какие — никогда), как добавить ключ в Freya и что делать, если подключение не проходит проверку. Если вам нужна картина целиком — почему это безопасно, — сначала прочитайте статью Безопасны ли мои деньги на Freya Finance?.
Key Takeaways
- Биржа подключается через API ключ — ограниченные учётные данные — а не переводом средств или передачей пароля от биржи.
- Ключу нужны разрешения на чтение и на спот- и/или фьючерсную торговлю. У него НИКОГДА не должно быть разрешения на вывод средств.
- Ключи OKX требуют пароль-фразу, которую вы задаёте при их создании; у Binance и Bybit её нет.
- Добавьте ключ в Freya в разделе Настройки → API ключи → Добавить API ключ, и Freya проверит его мгновенно.
- Если проверка не прошла, Freya точно сообщит причину — недействительный ключ, IP не в белом списке или отсутствующее разрешение — и у каждой есть простое решение.
Краткий обзор шагов
- Создайте API ключ на бирже с разрешениями на чтение и торговлю, но без вывода средств.
- Скопируйте учётные данные — API ключ, секретный ключ и (для OKX) пароль-фразу.
- Добавьте ключ в Freya в разделе Настройки → API ключи → Добавить API ключ и выберите свою биржу.
- Дайте Freya проверить его — Freya сразу проверяет подключение и разрешения.
- Устраните ошибку, если она возникнет — Freya точно скажет, что не так, если проверка не прошла.
Что такое API ключ и какие разрешения нужны Freya
API ключ — это пара учётных данных (ключ и секретный ключ), которая позволяет приложению ограниченно взаимодействовать с вашим счётом на бирже. Вы сами решаете, что этому ключу разрешено делать. Для Freya включите только:
- Чтение — чтобы Freya видела ваши балансы, позиции и статус ордеров.
- Спот-торговля и/или фьючерсная торговля — чтобы ваш бот мог размещать нужные ему ордера. Включите то, что соответствует ботам, которых вы планируете запускать.
Freya размещает сделки; ей никогда не нужно выводить деньги с вашего счёта. Всегда оставляйте разрешение на вывод средств отключённым на подключаемом ключе. Этим разрешением управляете вы на стороне биржи — пока оно выключено, ни Freya, ни тот, кто мог бы завладеть ключом, не сможет вывести ваши средства. Это самая важная привычка при подключении любой ботовой платформы.
Шаг 1: Создайте API ключ на бирже
В разделе управления API вашей биржи создайте новый API ключ:
- Binance — создайте ключ в разделе API Management, включите чтение и спот- и/или фьючерсную торговлю, а вывод средств оставьте отключённым.
- OKX — создайте ключ и задайте пароль-фразу (она понадобится вам в Freya); включите чтение и торговлю, но не вывод средств.
- Bybit — создайте ключ с разрешениями на чтение и торговлю для тех продуктов, которыми будете пользоваться, а вывод средств оставьте отключённым.
Если ваша биржа предлагает белый список IP, хорошей практикой будет ограничить ключ IP-адресами Freya. Если вы это делаете, обязательно внесите IP-адреса Freya в белый список, иначе подключение будет отклонено (см. таблицу ошибок ниже).
При создании ключа биржа показывает секретный ключ всего один раз. Скопируйте его сразу и храните в безопасном месте. Если вы его потеряете, восстановить его не получится — придётся удалить ключ и создать новый.
Шаг 2: Добавьте ключ в Freya
В Freya перейдите в Настройки → API ключи и выберите Добавить API ключ. Затем:
- Выберите свою биржу (Binance, OKX или Bybit).
- Вставьте API ключ и секретный ключ. Для OKX также введите заданную вами пароль-фразу.
- Дайте ключу название, чтобы позже его было легко узнать.
Вы можете подключить несколько бирж, а управлять ключами или удалять их можно в любой момент на этой же странице.
Шаг 3: Freya проверяет ваш ключ
Как только вы добавляете ключ, Freya проверяет подключение и разрешения — гадать не приходится. Если всё верно, ключ подтверждён и готов к работе. Если что-то не так, Freya покажет понятное сообщение с точным объяснением, что нужно исправить.
Разбираемся с ошибками проверки
Если проверка не прошла, сопоставьте сообщение Freya с решением ниже:
| Что показывает Freya | Что это значит | Как исправить |
|---|---|---|
| Недействительный API ключ | Ключ скопирован неверно или удалён на бирже | Скопируйте API ключ заново в точности или создайте новый |
| Недействительный секретный ключ | Секретный ключ не соответствует API ключу | Скопируйте секретный ключ заново; если вы его потеряли, создайте новый ключ |
| IP-адрес не в белом списке | Ключ ограничен по IP, и адрес Freya не разрешён | Внесите IP-адреса Freya в белый список ключа или снимите ограничение по IP |
| Отсутствующие разрешения | У ключа нет разрешения на чтение или торговлю | Включите на ключе чтение и спот-/фьючерсную торговлю |
| Разрешение на чтение отключено | Freya не может прочитать данные вашего счёта | Включите на ключе разрешение на чтение/просмотр |
| Разрешение на спот/фьючерсы отключено | Ключ не может размещать ордера, нужные вашему боту | Включите тип торговли (спот или фьючерсы), соответствующий вашему боту |
| Ошибка подключения | Временная проблема сети или биржи | Подождите немного и попробуйте добавить ключ снова |
Freya также отметит ключ, который находится в режиме «Без ограничений» — то есть не имеет ограничения по IP. Ради вашей безопасности Freya попросит включить ограничение по IP и добавить показанный адрес, прежде чем ключ можно будет сохранить. Включайте только чтение и торговлю (никогда не вывод средств) и ограничивайте ключ IP-адресом Freya. (Подробнее об ошибках подключения — в статье Не удаётся подключить биржу?.)
Несколько слов о безопасности
Подключение безопасно по своей конструкции, но несколько привычек помогают таким его и сохранить:
- Вывод средств всегда отключён — Freya он никогда не нужен.
- Используйте белый список IP, когда ваша биржа это поддерживает.
- Один ключ — одна задача, и удаляйте ключи, которыми больше не пользуетесь.
Чтобы получить полную картину того, как защищены ваши средства и ключи, см. Безопасны ли мои деньги на Freya Finance? и Безопасность API биржи и снижение рисков.
Часто задаваемые вопросы
Какие разрешения нужны Freya на моём API ключе?
Чтение (чтобы видеть ваши балансы, позиции и ордера) и спот- и/или фьючерсная торговля (чтобы размещать ордера вашего бота). Включите тот тип торговли, который соответствует ботам, которых вы будете запускать. Разрешение на вывод средств Freya никогда не нужно, поэтому всегда оставляйте его отключённым.
Нужно ли Freya разрешение на вывод моих средств?
Нет. Freya только размещает сделки и управляет ими; она не может и не должна иметь возможности выводить средства с вашей биржи. Всегда оставляйте разрешение на вывод отключённым на подключаемом ключе — этим разрешением управляете вы на стороне биржи.
Почему Freya пишет «IP-адрес не в белом списке»?
Ваш API ключ ограничен определёнными IP-адресами, а адреса Freya нет в списке. Либо добавьте IP-адреса Freya в белый список ключа на бирже, либо снимите ограничение по IP с ключа. После обновления добавьте ключ в Freya заново.
Почему появляется «Недействительный API ключ» или «Недействительный секретный ключ»?
Обычно ключ или секретный ключ скопирован неверно, либо ключ был удалён или перевыпущен на бирже. Скопируйте оба значения заново в точности. Поскольку секретный ключ показывается только один раз при создании ключа, если его у вас больше нет — удалите ключ на бирже и создайте новый.
Что такое пароль-фраза и почему OKX её запрашивает?
API ключи OKX включают пароль-фразу, которую вы задаёте сами при создании ключа, — это дополнительные учётные данные помимо ключа и секретного ключа. Введите ту же пароль-фразу в Freya при добавлении ключа OKX. Binance и Bybit пароль-фразу не используют.
Можно ли подключить несколько бирж?
Да. Вы можете добавить API ключи для Binance, OKX и Bybit, а управлять ими или удалять их можно в любой момент в разделе Настройки → API ключи.
Безопасно ли передавать Freya свой API ключ?
Да, если ключ настроен правильно — только чтение и торговля, без вывода средств и с белым списком IP там, где это возможно. Ваши средства остаются на вашей собственной бирже, а переданный ключ не может их переместить. Полное объяснение — в статье Безопасны ли мои деньги на Freya Finance?
Какие биржи поддерживает Freya?
В настоящее время Freya подключается к Binance, OKX и Bybit (спот и фьючерсы). Со временем могут быть добавлены другие биржи. Вы торгуете на той из них, которую подключили, — ваши средства и доступные рынки остаются на этой бирже.
Какими монетами или торговыми парами я могу торговать?
Доступные пары берутся из листингов вашей подключённой биржи, а не из отдельного списка Freya, — поэтому если биржа листит пару (например, BTC/USDT, ETH/USDT), вы можете построить на ней бота. Большая часть торговли ведётся против USDT в качестве котируемой валюты. Если биржа делистит пару, торговать ею там станет невозможно.