Коли ви додаєте 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.