Подключите Bybit к Freya

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

Этот путь называется Быстрое подключение. Старый путь, где вы создаёте ключ на Bybit самостоятельно, по-прежнему существует и работает. Это руководство охватывает оба, а также что делать, когда нужно заменить ключ или когда подключение не удаётся.

Key Takeaways

Быстрое подключение — это один клик: вы подтверждаете доступ Freya на Bybit, и оба ваших ключа — Spot и Futures — добавляются автоматически.
Быстрому подключению не нужен белый список IP — Bybit сам привязывает ключ к серверам Freya, поэтому же ключ и не истекает.
Ручное подключение по-прежнему работает и остаётся единственным путём на Binance и OKX.
Какой бы путь вы ни выбрали, ключ никогда не получает разрешение на вывод средств. Freya не может перемещать ваши средства.
Повторное подключение не создаёт дубликатов — Bybit выпускает один ключ на платформу на аккаунт, поэтому оно обновляет то, что у вас уже есть.

Прежде чем начать

Сначала стоит проверить две вещи.

Пополните счёт, который подключаете. Бот не может открыть позицию на пустом балансе, а Freya спокойно подключит ключ, которому нечем торговать. Если вы планируете запускать фьючерсных ботов, убедитесь, что средства находятся на том счёте, которым будут пользоваться ваши боты.

Используйте браузер. Оба пути работают в браузере на компьютере и телефоне. Создать API ключ вручную можно только через браузер на стороне Bybit — их мобильное приложение не показывает экран API ключей.

Быстрое подключение

Это путь, который мы рекомендуем. Он занимает около пятнадцати секунд, если вы уже вошли в Bybit.

В Freya откройте Настройки → API ключи и выберите Добавить API ключ.
Выберите биржу Bybit. Вкладка Быстрое подключение уже выбрана.
Нажмите Подключить Bybit. Откроется вкладка Bybit.
Войдите в Bybit. Если у вас ещё нет аккаунта, вы можете создать его прямо там и вернуться — подключение вас подождёт.
Прочитайте и подтвердите. Bybit показывает вам ровно то, что запрашивает Freya. Подтверждение — единственный шаг, который что-либо выдаёт.
Вкладка закроется сама, и ваши ключи появятся в Freya, готовые к работе.

Одно подтверждение охватывает и Spot, и Futures. Повторять это для каждого рынка не нужно.

Что происходит за кулисами

Когда вы подтверждаете доступ, Bybit создаёт API ключ, привязанный к брокерской регистрации Freya, и отправляет его прямо на серверы Freya. Поскольку он приходит именно так, он никогда не проходит через ваш браузер, буфер обмена или скриншот — а именно так API ключи чаще всего и утекают.

Bybit также сам привязывает этот ключ к серверам Freya. Два следствия, которые играют вам на руку:

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

Если вы передумаете

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

Закрытие вкладки Bybit без решения имеет тот же эффект.

Замена ключа Bybit

Иногда нужен свежий ключ — вы отозвали старый на Bybit, переходите на другой аккаунт Bybit, или поддержка попросила вас переподключиться.

С Быстрым подключением просто подключитесь ещё раз. Откройте Настройки → API ключи → Добавить API ключ, выберите Bybit и нажмите Подключить Bybit, как и раньше. Bybit выпускает один ключ на платформу на аккаунт, поэтому переподключение обновляет то, что у вас уже есть, а не наслаивает вторую копию. Ваши существующие боты продолжают работать на обновлённых учётных данных.

Если вы сначала удалили ключ на стороне Bybit, переподключение — тоже решение: при подтверждении Bybit выпустит новый.

⚠️ Не удаляйте свой ключ в Freya, пока работают боты, если только вы не собираетесь их остановить. Работающий бот без действующих учётных данных не может управлять уже открытой позицией. Сначала остановите или закройте ботов, затем переподключитесь.

Ручное подключение

Используйте этот путь, если предпочитаете создать ключ самостоятельно или подключаете субаккаунт Bybit.

Создайте ключ на Bybit

Войдите в Bybit в браузере и откройте раздел API своего аккаунта.
Создайте сгенерированный системой (System-generated) API ключ.
Выберите API Transaction как тип использования — не режим «только чтение».
Выдайте разрешения Contract Trade и Spot Trade, а также доступ на чтение.
Никогда не выдавайте разрешение на вывод средств (Withdrawal). Freya оно не нужно, и она не может им воспользоваться.
Ограничьте ключ по IP и введите адрес Freya — модальное окно показывает его и позволяет скопировать.

⚠️ Bybit показывает ваш секретный ключ ровно один раз. Скопируйте его до того, как закроете этот экран. Если вы его потеряете, восстановить ключ не получится — придётся создать новый.

Добавьте ключ в Freya

В Freya откройте Настройки → API ключи → Добавить API ключ и выберите Bybit.
Переключитесь на вкладку Ручное подключение.
Вставьте API ключ и секретный ключ и дайте ключу название, которое вы потом узнаете.
Нажмите Добавить API ключ. Freya сразу проверит подключение и разрешения.

Если проверка не пройдена, Freya сообщает, какая именно часть не прошла, а не показывает общую ошибку. Каждое сообщение и его решение — в статье Исправление ошибок подключения API-ключа биржи.

Часто задаваемые вопросы

Каким путём пользоваться?

Быстрым подключением, если только у вас нет особой причины поступить иначе. В нём меньше шагов, его нельзя испортить опечаткой, и оно полностью убирает белый список IP. Ручное подключение существует для тех, кто хочет создавать и контролировать ключ самостоятельно, и для субаккаунтов.

Даёт ли Быстрое подключение Freya больше доступа, чем ручной ключ?

Нет. Оба пути дают торговый ключ с одинаковым объёмом доступа: чтение и торговля, никогда — вывод средств. Разница в том, кто выполняет настройку, а не в том, что может ключ.

Нужно ли вносить IP-адрес в белый список?

Только при Ручном подключении. При Быстром подключении Bybit автоматически привязывает ключ к серверам Freya — поэтому же такой ключ и не истекает.

Можно ли подключить Bybit Spot и Futures по отдельности?

С Быстрым подключением это не нужно — одно подтверждение настраивает оба. С Ручным подключением вы можете добавить отдельные ключи, если предпочитаете держать рынки раздельно.

Что будет, если я подключусь дважды?

Ничего не сломается и ничего не задублируется. Bybit выпускает один ключ на платформу на аккаунт, поэтому повторное подключение обновляет существующий.

Можно ли использовать Быстрое подключение с субаккаунтом Bybit?

Для субаккаунтов используйте Ручное подключение. Быстрое подключение предназначено для вашего основного аккаунта Bybit.

В безопасности ли мой ключ, когда он уже в Freya?

Он шифруется в момент получения и больше никогда не отображается — ни вам, ни поддержке. Удаление в Freya стирает сохранённые учётные данные, а отзыв на Bybit перекрывает доступ с другой стороны. Полная картина — в статье Безопасны ли мои деньги на Freya Finance?.

Freya пишет, что мой ключ недействителен сразу после подключения. Почему?

Чаще всего ключ был создан без разрешения на торговлю или ограничен IP-адресом, который не принадлежит Freya. При Быстром подключении ни то ни другое невозможно, поэтому переподключение этим путём — обычно самое быстрое решение.