Быстрое подключение OKX к Freya: как работает и что делать при ошибке

Подключение OKX вручную требует больше шагов, чем на большинстве бирж. Нужно создать API-ключ, выбрать разрешения, задать парольную фразу, скопировать секрет, который показывается только один раз, и вставить все три значения в Freya без ошибок.

С быстрым подключением ничего из этого не нужно. Freya является зарегистрированным брокером OKX, что позволяет OKX создать ключ внутри вашего аккаунта и передать его Freya напрямую. Вы одобряете один раз на экране OKX, и оба подключения (Spot и Futures) появляются в Freya.

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

Что на самом деле означает «один клик»

Ключ создаёт OKX, а не вы. После вашего одобрения OKX создаёт API-ключ для Freya внутри вашего аккаунта OKX. Он отображается на OKX под именем FreyaFinance.

Учётные данные не проходят через ваши руки. Ключ и его секрет передаются от OKX напрямую на серверы Freya и хранятся в зашифрованном виде вместе с парольной фразой ключа. Ничего не копируется через буфер обмена, сообщение в чате или скриншот, а именно так API-ключи чаще всего утекают.

Не нужно придумывать парольную фразу и вставлять IP-адрес. Ключи OKX всегда имеют парольную фразу. При быстром подключении Freya задаёт её за вас и хранит вместе с ключом, поэтому запоминать ничего не нужно. IP-адрес тоже никуда копировать не нужно.

Что вы одобряете

Ключ, создаваемый при быстром подключении, может:

• Читать ваши балансы, позиции и историю ордеров
• Создавать, изменять и отменять ордера, что позволяет боту торговать

Он не может:

• Выводить или переводить средства. Freya никогда не запрашивает право на вывод. Если ключ поступает с возможностью вывода, Freya отклоняет его и не сохраняет.
• Изменять пароль OKX или настройки безопасности.

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

Процесс шаг за шагом

1. Откройте Настройки → API ключи и выберите Добавить API ключ.
2. Выберите OKX. Вкладка Быстрое подключение выбрана по умолчанию.
3. Нажмите Подключить OKX. Страница переходит на OKX в той же вкладке.
4. Войдите в OKX с помощью основного аккаунта или сначала создайте аккаунт OKX, если у вас его нет.
5. Просмотрите запрос и одобрите его.
6. Вы возвращаетесь в Freya и видите OKX подключён: ваши ключи OKX Spot и OKX Futures добавлены.

Завершайте в том же браузере, в котором начали. Если страница, вернувшаяся в Freya, не та, что начала процесс, или вы слишком долго ждали на OKX, вы увидите This attempt could not be matched. Ничего не было создано; начните подключение заново с того же экрана.

Если вы отклоните запрос

Ничего не создаётся и ничего не меняется. Freya показывает Connection cancelled (You declined on OKX's screen, so no API key was created.), и вы можете попробовать снова в любое время.

Если OKX не создал ключ

Иногда OKX не позволяет подключению создать ключ. Вы увидите OKX не создал ключ, и в вашем аккаунте OKX ничего не добавлено. Подключитесь с помощью ключа, созданного вами самостоятельно, на вкладке Ручное подключение; инструкция приведена в статье Как подключить биржу к Freya.

Что меняется в вашем аккаунте OKX при подключении

Быстрое подключение подготавливает ваш аккаунт, чтобы могли работать боты для Spot и Futures. Две настройки могут измениться, и о них стоит знать до одобрения.

Режим аккаунта. Для фьючерсов нужен режим аккаунта OKX, который их поддерживает. Если ваш аккаунт находится в режиме Spot, Freya переключает его в режим Futures. Если OKX не позволяет переключение (например, из-за открытых позиций или ордеров), подключение всё равно работает для Spot. Freya показывает Нужен режим Futures на OKX. Спот готов и объясняет решение: для запуска фьючерсных ботов переключите аккаунт в режим Futures на OKX в разделе Trade → Account mode.

Режим позиций. Фьючерсные боты Freya используют режим long/short (хеджирование), чтобы длинные и короткие позиции могли быть открыты одновременно. Freya включает его при подключении. Если у вас есть открытые позиции в режиме One-Way, переключение ожидает их закрытия, и вы увидите Will activate once your open One-Way positions close.

Ничего другого в вашем аккаунте не меняется, и ваши средства остаются на месте.

Один ключ Freya на аккаунт OKX

OKX позволяет каждому аккаунту иметь один ключ для Freya. Большинство сообщений, с которыми вы можете столкнуться, связаны с этим правилом.

Этот аккаунт уже подключён здесь. Повторное подключение ничего не меняет: вы видите Этот аккаунт OKX уже подключён. Это защищает ключ, который используют ваши боты прямо сейчас.

У OKX уже есть ключ Freya. Ключ от предыдущего подключения всё ещё на OKX, поэтому OKX не создал новый. Freya показывает В OKX уже есть ключ Freya с тремя шагами:

1. Откройте страницу авторизации OKX по кнопке, которую показывает Freya.
2. Удалите FreyaFinance на этой странице. Его API-ключ удаляется вместе с ним. Другие ваши API-ключи не затрагиваются.
3. Вернитесь и нажмите Попробовать снова.

Ключ принадлежит другому аккаунту Freya. Если вы видите сообщение Этот аккаунт OKX подключён к другому аккаунту Freya, не удаляйте ничего на OKX: боты на том другом аккаунте остановятся. Добавьте OKX в этот аккаунт на вкладке Ручное подключение.

Freya не может определить, кто использует ключ. Если Freya показывает Проверьте, прежде чем что-то удалять в OKX, удаляйте FreyaFinance, только если уверены, что ни один аккаунт Freya его не использует. Если не уверены, используйте ручное подключение.

Замена ключа, который перестал работать

1. Остановите ботов, использующих ваши ключи OKX. Freya не удалит ключ, который использует работающий бот.
2. Удалите OKX Spot и OKX Futures на странице API ключи. Они используют один ключ на OKX.
3. Удалите FreyaFinance на странице авторизации OKX. Удаление только в Freya оставляет старый ключ на OKX.
4. Подключитесь заново через быстрое подключение, затем привяжите ботов к новым ключам.

После подключения

Ваши ключи отображаются в разделе Настройки → API ключи как OKX Spot и OKX Futures, и любой созданный вами бот может сразу их использовать. Ключ, добавленный ранее вручную, не затрагивается; оба могут существовать одновременно.

Вход через OKX. Когда ваш основной аккаунт OKX подключён таким способом, вы также можете использовать его для входа. Включите это в разделе Настройки → Настройки профиля → Способы входа. Функция работает, пока подключение активно: если вы его удалите, переключатель предложит вам сначала подключить этот аккаунт OKX снова.

Удаление доступа в ваших руках. Удаление ключей в Freya удаляет копию Freya, но оставляет ключ на OKX; затем Freya покажет, как удалить его там. Удаление FreyaFinance на странице авторизации OKX удаляет ключ на OKX, и оба подключения (OKX Spot и OKX Futures) сразу перестают работать.

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

Безопасно ли быстрое подключение к OKX?

Оно как минимум так же безопасно, как создание ключа вручную. OKX создаёт ключ внутри вашего аккаунта, и он передаётся напрямую на серверы Freya, поэтому секрет никогда не оказывается в буфере обмена или на скриншоте. Вы одобряете на домене OKX и можете отклонить запрос, при этом ничего не будет создано.

Видит ли Freya мой пароль от OKX?

Нет. Вы входите на сайте OKX, а не Freya. Freya никогда не получает данные для входа в OKX.

Может ли Freya вывести мои средства?

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

Нужно ли мне создавать парольную фразу?

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

Нужно ли настраивать Spot и Futures отдельно?

Нет. Одно одобрение добавляет и OKX Spot, и OKX Futures. Они используют один ключ на OKX.

Изменит ли подключение что-то в моём аккаунте OKX?

Оно может изменить две настройки, чтобы фьючерсные боты могли работать: режим аккаунта (если ваш аккаунт в режиме Spot) и режим позиций (на long/short). Freya сообщит, если какую-то из них не удалось изменить. Также добавляется один ключ с именем FreyaFinance, который вы можете удалить на странице авторизации OKX в любое время.

Могу ли я использовать суб-аккаунт OKX?

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

Могу ли я подключиться вручную, если предпочитаю?

Да. Вкладка Ручное подключение всегда доступна. Инструкция по ручному подключению, включая парольную фразу, приведена в статье Как подключить биржу к Freya.

Дополнительное чтение

• Торговый бот для OKX: что можно автоматизировать на OKX с Freya
• Как подключить биржу к Freya: ручной способ подключения для каждой биржи
• Как управлять API-ключами биржи на Freya Finance
• Исправление ошибок подключения API-ключа биржи
• Быстрое подключение к Bybit
• Безопасны ли мои деньги на Freya Finance?