Саме ваші API-ключі дозволяють Freya розміщувати ордери на вашій біржі замість вас. Щойно ви підключили біржу, усі ваші ключі зібрані в одному місці, де ви можете їх переглянути, побачити, що саме дозволено кожному з них, додати нові або видалити ті, якими більше не користуєтеся. Цей посібник — про керування ними.
Якщо ви підключаєте біржу вперше, почніть із матеріалу Як підключити свою біржу — ця стаття про керування ключами, які ви вже додали.
Головне
- Усі підключені API-ключі бірж зібрані в розділі Налаштування → API-ключі, де видно біржу, назву, дату додавання та статус.
- Кожен ключ показує свої дозволи — Read, Trade і (для ф'ючерсів) доступ Futures — тож ви точно бачите, що він дозволяє.
- Ви можете будь-коли додати ще один ключ або видалити той, яким більше не користуєтеся.
- Freya не видалить ключ, поки ним користується бот — спершу зупиніть або призупиніть ці боти; видалення незворотне, і ви отримуєте сповіщення щоразу, коли ключ видаляють.
- Ваші облікові дані API зберігаються в зашифрованому вигляді, і Freya ніколи не потребує дозволу на виведення для ваших ключів.
Стисло про кроки
- Відкрийте список ключів — перейдіть до Налаштування → API-ключі, щоб побачити кожне підключення до біржі разом із назвою, датою додавання та статусом.
- Перевірте дозволи кожного ключа — переконайтеся, що показані Read і Trade (та Futures, якщо ви торгуєте ф'ючерсами) і ніколи — доступ до виведення.
- Додайте ключ, коли він потрібен — скористайтеся кнопкою «Додати API-ключ», щоб підключити ще одну біржу або додатковий ключ; процес такий самий, як під час першого підключення.
- Видаляйте ключі, якими більше не користуєтесь — оберіть Видалити та підтвердьте. Якщо якийсь бот усе ще використовує цей ключ, Freya відхилить видалення й повідомить, скільки їх; спершу зупиніть або призупиніть їх.
Де знайти свої API-ключі
Перейдіть до Налаштування → API-ключі. Ви побачите розділ Ваші API-ключі — список усіх підключень до бірж на вашому обліковому записі. Для кожного з них Freya показує:
- Біржу (Binance, OKX або Bybit).
- Назву ключа, щоб ви могли розрізняти кілька ключів.
- Дату додавання.
- Його статус (Активний).
Якщо ви ще нічого не підключили, замість списку побачите запрошення Додайте свій перший API-ключ.
Що означають дозволи ключа
Кожен ключ відображає дозволи, з якими його було створено, тож жодних сумнівів щодо його можливостей не залишається:
- Read — дозволяє Freya бачити ваші баланси та позиції (потрібно для всього).
- Trade — дозволяє Freya розміщувати ордери й керувати ними (саме це використовують ваші боти для торгівлі).
- Futures — з'являється, коли для ключа також увімкнено доступ до ф'ючерсної торгівлі.
Ця прозорість важлива: ключ Freya призначений лише для читання й торгівлі. Він не має — і не повинен мати — дозволу на виведення, тому ваші кошти ніколи не зможуть залишити вашу біржу через Freya. Повну картину дивіться в статті Чи мої гроші в безпеці на Freya Finance?.
Додавання ще одного ключа
Ви можете підключити більше однієї біржі (або більше одного ключа) з того самого екрана за допомогою кнопки Додати API-ключ. Налаштування відбувається так само, як під час першого підключення — покроковий опис, зокрема про passphrase для OKX, дивіться в матеріалі Як підключити свою біржу.
Видалення ключа
Щоб прибрати підключення, оберіть Видалити біля ключа та підтвердьте дію. Кілька важливих моментів:
- Це неможливо скасувати. Щоб відновити підключення, доведеться додавати ключ заново з нуля.
- Freya перевіряє перед видаленням. Якщо якийсь бот працює з цим ключем або готовий і чекає на торгівлю, видалення відхиляється, і вам повідомляють, скільки ботів задіяно. Зупиніть або призупиніть їх у панелі та спробуйте знову — бот, який втратив ключ посеред угоди, більше не може керувати вже відкритою позицією.
- Ви отримаєте сповіщення про видалення ключа — це елемент безпеки, завдяки якому ви завжди знаєте про зміни в доступі.
Ваші ключі зберігаються надійно
Freya зберігає ваші облікові дані API в зашифрованому вигляді — екран API-ключів навіть позначає їх як надійно збережені. У поєднанні з ключами, які не мають дозволу на виведення, це означає, що навіть у найгіршому випадку ніхто не зможе вивести кошти з вашого біржового рахунку через Freya.
Часті запитання
Де я можу керувати API-ключами своїх бірж?
У розділі Налаштування → API-ключі. На цьому екрані перелічено кожен підключений ключ із біржею, назвою, датою додавання та статусом — і саме там ви додаєте нові ключі або видаляєте наявні.
Що означають позначки Read, Trade і Futures?
Вони показують, що дозволено кожному ключу. Read дозволяє Freya бачити ваші баланси та позиції; Trade — розміщувати ордери й керувати ними (це те, що використовують ваші боти); а Futures з'являється, коли для ключа також увімкнено доступ до ф'ючерсної торгівлі. Ключ Freya ніколи не потребує дозволу на виведення.
Як додати ще одну біржу або ключ?
Скористайтеся кнопкою «Додати API-ключ» на тому самому екрані. Вона запускає той самий процес підключення, що й для вашого першого ключа — повний покроковий опис, зокрема про додатковий passphrase на OKX, дивіться в посібнику «Як підключити свою біржу».
Що станеться, коли я видалю API-ключ?
Freya спершу перевіряє, чи щось іще від нього залежить. Якщо бот працює з цим ключем або чекає на сигнал, видалення відхиляється, і ви побачите, скільки ботів задіяно — зупиніть або призупиніть їх, а потім видаляйте. Коли від ключа ніщо не залежить, з'єднання видаляється, і це незворотно. Ви також отримаєте сповіщення про видалення ключа.
Чи безпечно зберігаються мої API-ключі?
Так. Ваші облікові дані зберігаються в зашифрованому вигляді, а ключі, які ви підключаєте, мають лише доступ до торгівлі — ніколи дозвіл на виведення. Це поєднання означає, що ваші кошти не можна вивести з вашої біржі через Freya.
Чи може Freya вивести мої кошти за допомогою мого API-ключа?
Ні. Ключі створюються лише з доступом на читання й торгівлю — без виведення. Навіть якби щось пішло не так, ніхто не зміг би перемістити ваші кошти з біржі за допомогою ключа Freya.
Як змінити дозволи API-ключа, замінити його або вимкнути?
Для підключеного ключа немає редагування на місці. Щоб змінити дозволи, оновити чи замінити ключ, ви видаляєте його з Freya й додаєте новий — створіть оновлений ключ на біржі, потім підключіть його знову. Спершу зупиніть або призупиніть боти, що використовують старий ключ, оскільки Freya не видалить ключ, який ще використовується; після підключення нового спрямуйте ці боти на нього й запустіть знову. Щоб припинити використання ключа, не видаляючи його, призупиніть залежні від нього боти замість видалення ключа.