Когда вы добавляете API-ключ биржи, Freya проверяет его перед сохранением — и если что-то не так, сообщает, что именно нужно исправить. Это руководство поможет прочитать результат проверки и устранить проблему. (Если ключ подключился нормально, но бот позже остановился — это другая история, смотрите Почему мой бот приостановился или остановился?.)
Если вы настраиваете всё впервые, начните с руководства Как подключить биржу; эта статья — о том, что делать, когда подключение не удаётся.
Главное
- При добавлении ключа Freya проверяет, что он подключается и имеет нужные права, и только потом сохраняет его — если что-то не проходит проверку, текст ошибки подсказывает, что исправить.
- «Неверный API-ключ / секретный ключ» обычно означает опечатку при копировании или ключ, который был пересоздан; ошибки с «IP» означают, что ограничение по IP на ключе не соответствует тому, что нужно Freya.
- У ключа должны быть права на чтение и торговлю (никогда — на вывод средств), и он должен быть включён для нужного рынка — спот или фьючерсы — в соответствии с вашим ботом.
- Ключи OKX требуют пароль-фразу, которая должна совпадать в точности; для фьючерсных ключей Freya автоматически подготавливает ваш аккаунт, чтобы бот мог корректно торговать.
- Общая ошибка «Подключение не удалось» чаще всего означает кратковременный сбой сети или биржи — просто попробуйте ещё раз.
Когда ключ не подключается
Добавление ключа — не сохранение вслепую: Freya проверяет, что ключ работает и имеет нужные права, и только после этого сохраняет его в зашифрованном виде. Если что-то не так, ошибка указывает прямо на причину — обычно это ключ или секрет, ограничение по IP либо отсутствующее право. Ниже разберём каждую ошибку и способ её устранения.
«Неверный API-ключ» или «Неверный секретный ключ»
Самая частая ошибка подключения — и, как правило, самая простая:
- Опечатка при копировании — лишний пробел или потерянный символ. Аккуратно скопируйте заново и ключ, и секрет.
- Секрет показывается только один раз. Биржи раскрывают секретный ключ единственный раз — в момент создания. Если вы его не сохранили, восстановить его невозможно — создайте новый ключ.
- Ключ был удалён или пересоздан на бирже, поэтому он больше не совпадает.
Решение: введите ключ и секрет заново в точности или создайте новый ключ и повторите попытку.
Ошибки ограничения по IP
Freya подключается со своих собственных серверов, поэтому настройки IP на ключе имеют значение. Здесь есть два разных случая:
- «IP-адрес не в белом списке» — ваш ключ ограничен по IP, но адрес сервера Freya не внесён в его список разрешённых. Экран добавления API-ключа показывает IP-адрес(а), который нужно добавить (с кнопкой копирования) — добавьте их в белый список ключа на бирже.
- «Без ограничений» — у вашего ключа вообще нет ограничения по IP. Ради вашей безопасности Freya просит включить ограничение по IP и добавить показанный адрес, а затем повторить попытку.
В обоих случаях суть решения одна: ограничьте ключ тем IP-адресом, который Freya показывает в окне.
Ошибки прав доступа
Ключ подключился, но не может делать то, что нужно вашему боту:
- Чтение отключено — включите право на чтение/просмотр для ключа.
- Нет права на торговлю — включите торговлю (спот и/или фьючерсы — в соответствии с вашим ботом).
- Несовпадение спота и фьючерсов — фьючерсному боту нужен ключ с включённой фьючерсной торговлей; спотовому боту — со спотовой. Если вы добавили ключ только для спота к фьючерсному боту (или наоборот), Freya это отметит. Убедитесь, что рынок, включённый на ключе, соответствует боту, которого вы создаёте.
Помните: Freya нужны только права на чтение и торговлю — никогда на вывод средств. Ключ без права на вывод — именно то, что вам нужно.
Особенности отдельных бирж
- OKX требует пароль-фразу. При создании ключа OKX вы задаёте пароль-фразу — введите в Freya ровно ту же пароль-фразу, в точности как вы её задали. Неверная пароль-фраза — частая причина сбоя подключения к OKX.
- Настройка фьючерсов на OKX. Для фьючерсной торговли на OKX нужен определённый режим аккаунта, и Freya настраивает его за вас автоматически — вручную ничего делать не нужно.
- Режим хеджирования (фьючерсы). Для фьючерсных аккаунтов Freya использует режим хеджирования. Если у вас уже есть открытые односторонние позиции, которые этому мешают, вы можете увидеть предупреждение, а не ошибку — ключ всё равно сохранится, и ваш бот сможет торговать, как только эти позиции будут закрыты.
- Binance и Bybit пароль-фразу не используют — поля для неё у них нет.
«Подключение не удалось» без внятной причины
Общий сбой подключения часто не ваша вина — это может быть кратковременный сбой сети или временная загруженность биржи. Подождите немного и попробуйте снова. Если после нескольких попыток ошибка сохраняется, ещё раз проверьте ключ/секрет и настройки IP, описанные выше.
Ничего не помогает? Короткий чек-лист
- Создайте ключ заново на бирже — только с правами чтение + торговля (никогда на вывод средств).
- Ограничьте его тем IP-адресом, который Freya показывает на экране добавления API-ключа.
- Совместите рынок — спотовый ключ для спотового бота, фьючерсный ключ для фьючерсного бота.
- OKX: введите точную пароль-фразу.
- Всё ещё не работает? Напишите на [email protected].
Часто задаваемые вопросы
Freya пишет «Неверный API-ключ», но я уверен, что скопировал всё правильно — в чём дело?
Обычно в ключ или секрет прокрался невидимый символ или пробел, либо ключ был пересоздан/удалён на бирже и потому больше не совпадает. Аккуратно скопируйте заново оба поля и помните: секрет показывается только один раз, при создании — если его у вас нет, создайте новый ключ.
В чём разница между «IP-адрес не в белом списке» и «Без ограничений»?
«IP-адрес не в белом списке» означает, что ваш ключ ограничен по IP, но адрес сервера Freya ещё не разрешён — добавьте показанный Freya адрес в белый список ключа. «Без ограничений» означает, что у ключа вообще нет ограничения по IP; ради безопасности Freya просит включить ограничение по IP и добавить её адрес перед сохранением.
Мой ключ OKX не подключается — нужна ли пароль-фраза?
Да. У ключей OKX есть пароль-фраза, которую вы задаёте при создании ключа. В Freya нужно ввести именно эту пароль-фразу — неверная или отсутствующая пароль-фраза является частой причиной сбоя подключения к OKX. Binance и Bybit её не используют.
Freya пишет, что мой ключ не может выставлять ордера — как это исправить?
У вашего ключа не включена торговля для того рынка, который использует бот. На бирже включите право на торговлю — спотовую для спотового бота, фьючерсную для фьючерсного — и подключитесь заново. Freya нужны права на чтение и торговлю, никогда на вывод средств.
Моему фьючерсному ключу нужна дополнительная настройка (режим аккаунта / режим хеджирования) — это проблема?
Нет. Для фьючерсной торговли нужны определённый режим аккаунта и режим хеджирования, и Freya настраивает их за вас автоматически. Если у вас есть открытые односторонние позиции, вы можете увидеть предупреждение о режиме хеджирования вместо ошибки — ключ всё равно сохранится, и ваш бот сможет торговать, как только эти позиции будут закрыты.
Я добавил спотовый ключ, но мой фьючерсный бот его не использует (или наоборот) — почему?
Ключ включён для конкретного рынка. Фьючерсному боту нужен ключ с включённой фьючерсной торговлей, а спотовому — со спотовой. Если они не совпадают, Freya это отметит. Подключите ключ, рынок которого соответствует создаваемому боту.
Подключение просто «не удалось» без внятной причины — это из-за меня или из-за биржи?
Чаще это кратковременный сбой сети или биржи, а не ваши настройки. Попробуйте ещё раз через минуту. Если ошибка повторяется, перепроверьте ключ и секрет на предмет опечаток при копировании и убедитесь, что ограничение по IP соответствует адресу, который показывает Freya.