Підключення 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. Зі Швидким підключенням ані те, ані інше неможливе, тож перепідключення цим шляхом — зазвичай найшвидше виправлення.
Читайте також
- Швидке підключення до Bybit: як працює налаштування в один клік
- Як підключити біржу до Freya Finance — загальний посібник, що охоплює також Binance та OKX
- Виправлення помилок підключення API-ключа біржі
- Безпека API бірж та зниження ризиків
