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