Перш ніж бот зможе торгувати за вас, Freya потрібне підключення до біржі, де зберігаються ваші кошти, — Binance, OKX або Bybit. Для цього ви не переказуєте свої кошти й не передаєте пароль. Натомість ви створюєте API-ключ: обмежені облікові дані, які дозволяють Freya розміщувати ордери від вашого імені, тоді як ваші гроші залишаються на вашому власному біржовому рахунку.
Цей посібник пояснює, які саме дозволи надавати (і які не надавати ніколи), як додати ключ у Freya та що робити, якщо підключення не проходить перевірку. Якщо хочете побачити ширшу картину того, чому це безпечно, спершу прочитайте Чи безпечні мої гроші на Freya Finance?.
Головне
- Ви підключаєте біржу за допомогою API-ключа — обмежених облікових даних — а не переказуючи кошти чи передаючи пароль від біржі.
- Ключу потрібні дозволи на читання та на спотову і/або ф'ючерсну торгівлю. Він НІКОЛИ не повинен мати дозволу на виведення.
- Ключі OKX вимагають passphrase, який ви задаєте під час їх створення; Binance і Bybit — ні.
- Додайте ключ у Freya через Налаштування → API-ключі → Додати API-ключ, і Freya миттєво його перевірить.
- Якщо перевірка не пройшла, Freya точно скаже чому — недійсний ключ, IP не в білому списку або відсутній дозвіл — і кожна причина має просте виправлення.
Короткий огляд кроків
- Створіть API-ключ на своїй біржі з дозволами на читання та торгівлю, але не на виведення.
- Скопіюйте облікові дані — API-ключ, секрет і (для OKX) passphrase.
- Додайте ключ у Freya через Налаштування → API-ключі → Додати API-ключ і виберіть свою біржу.
- Дайте Freya перевірити його — Freya одразу перевіряє підключення та дозволи.
- Виправте будь-яку помилку, про яку вона повідомить — Freya точно вкаже, що не так, якщо перевірка не пройшла.
Що таке API-ключ — і які дозволи потрібні Freya
API-ключ — це пара облікових даних (ключ і секрет), яка дозволяє застосунку обмежено взаємодіяти з вашим біржовим рахунком. Ви самі вирішуєте, що цьому ключу дозволено робити. Для Freya вмикайте лише:
- Читання — щоб Freya бачила ваші баланси, позиції та статус ордерів.
- Спотова торгівля та/або ф'ючерсна торгівля — щоб ваш бот міг розміщувати потрібні ордери. Вмикайте той тип, який відповідає ботам, які ви плануєте запускати.
Freya розміщує ордери; їй ніколи не потрібно виводити гроші з вашого рахунку. Завжди залишайте дозвіл на виведення вимкненим на ключі, який ви підключаєте. Це дозвіл, який контролюєте ви на боці біржі — коли він вимкнений, ані Freya, ані хтось, хто міг би отримати ключ, не зможе вивести ваші кошти. Це найважливіша звичка під час підключення до будь-якої ботоплатформи.
Крок 1: Створіть API-ключ на своїй біржі
У розділі керування API вашої біржі створіть новий API-ключ:
- Binance — створіть ключ у розділі API Management, увімкніть читання та спотову і/або ф'ючерсну торгівлю, а виведення залиште вимкненим.
- OKX — створіть ключ і задайте passphrase (він знадобиться вам у Freya); увімкніть читання та торгівлю, але не виведення.
- Bybit — створіть ключ із дозволами на читання та торгівлю для тих продуктів, якими користуватиметеся, і залиште виведення вимкненим.
Якщо ваша біржа пропонує білий список IP, гарною практикою буде обмежити ключ IP-адресами Freya. Якщо ви це робите, обов'язково додайте IP Freya до білого списку, інакше підключення буде відхилено (див. таблицю помилок нижче).
Коли ви створюєте ключ, біржа показує секрет один-єдиний раз. Скопіюйте його негайно та зберігайте в безпечному місці. Якщо ви його втратите, відновити не вийде — доведеться видалити ключ і створити новий.
Крок 2: Додайте ключ у Freya
У Freya перейдіть до Налаштування → API-ключі та виберіть Додати API-ключ. Далі:
- Виберіть свою біржу (Binance, OKX або Bybit).
- Вставте API-ключ і секрет. Для OKX також введіть passphrase, який ви задали.
- Дайте ключу назву, щоб потім легко його впізнати.
Ви можете підключити більше ніж одну біржу, а також керувати ключами чи видаляти їх на цій самій сторінці будь-коли.
Крок 3: Freya перевіряє ваш ключ
Щойно ви додаєте ключ, Freya перевіряє підключення та дозволи — жодних здогадок. Якщо все правильно, ключ підтверджено й готовий до використання. Якщо щось не так, Freya покаже зрозуміле повідомлення з точним поясненням, що виправити.
Як розуміти помилки перевірки
Якщо перевірка не пройшла, зіставте повідомлення, яке показує Freya, з виправленням нижче:
| Що показує Freya | Що це означає | Як виправити |
|---|---|---|
| Недійсний API-ключ | Ключ скопійовано неправильно або видалено на біржі | Скопіюйте API-ключ ще раз точно або створіть новий |
| Недійсний секретний ключ | Секрет не відповідає ключу | Скопіюйте секрет ще раз; якщо ви його втратили, створіть новий ключ |
| IP-адреси немає в білому списку | Ключ обмежений за IP, а адреса Freya не дозволена | Додайте IP Freya до білого списку ключа або зніміть обмеження за IP |
| Відсутні дозволи | Ключу бракує дозволу на читання або торгівлю | Увімкніть на ключі читання та спотову/ф'ючерсну торгівлю |
| Дозвіл на читання вимкнено | Freya не може прочитати ваш рахунок | Увімкніть на ключі дозвіл на читання/перегляд |
| Дозвіл на спот/ф'ючерси вимкнено | Ключ не може розміщувати ордери, потрібні вашому боту | Увімкніть тип торгівлі (спот або ф'ючерси), який відповідає вашому боту |
| Помилка підключення | Тимчасова проблема з мережею або біржею | Зачекайте трохи та спробуйте додати ключ ще раз |
Freya також позначить ключ, який перебуває в режимі «Unrestricted» — тобто без обмеження за IP. Заради вашої безпеки Freya попросить увімкнути обмеження за IP та додати показану адресу, перш ніж ключ можна буде зберегти. Вмикайте лише читання та торгівлю (ніколи не виведення) і обмежте ключ IP-адресами Freya. (Докладніше про помилки підключення — у статті Не вдається підключити біржу?.)
Кілька слів про безпеку
Підключення безпечне за задумом, але кілька звичок допомагають таким його й зберегти:
- Виведення вимкнене, завжди — Freya це ніколи не потрібно.
- Використовуйте білий список IP, коли ваша біржа це підтримує.
- Один ключ — одне призначення — і видаляйте ключі, якими більше не користуєтеся.
Щоб побачити повну картину того, як захищені ваші кошти та ключі, читайте Чи безпечні мої гроші на Freya Finance? та Безпека біржового API та зниження ризиків.
Часті запитання
Які дозволи потрібні Freya на моєму API-ключі?
Читання (щоб бачити ваші баланси, позиції та ордери) і спотова та/або ф'ючерсна торгівля (щоб розміщувати ордери вашого бота). Вмикайте той тип торгівлі, який відповідає ботам, які ви запускатимете. Дозвіл на виведення Freya не потрібен ніколи, тож завжди залишайте його вимкненим.
Чи потрібен Freya дозвіл на виведення моїх коштів?
Ні. Freya лише розміщує ордери та керує ними; вона не може й не повинна мати можливості виводити кошти з вашої біржі. Завжди залишайте дозвіл на виведення вимкненим на ключі, який ви підключаєте, — це дозвіл, який контролюєте ви на боці біржі.
Чому Freya пише «IP-адреси немає в білому списку»?
Ваш API-ключ обмежений конкретними IP-адресами, а адреси Freya немає у списку. Або додайте IP-адреси Freya до білого списку ключа на своїй біржі, або зніміть обмеження за IP з ключа. Після оновлення додайте ключ у Freya ще раз.
Чому пише «Недійсний API-ключ» або «Недійсний секретний ключ»?
Зазвичай ключ або секрет скопійовано неправильно, або ключ було видалено чи згенеровано заново на біржі. Скопіюйте обидва значення ще раз точно. Оскільки секрет показують лише один раз під час створення ключа, якщо його у вас більше немає — видаліть ключ на біржі та створіть новий.
Що таке passphrase і чому OKX його запитує?
API-ключі OKX містять passphrase, який ви задаєте самі під час створення ключа, — це додаткові облікові дані поряд із ключем і секретом. Вводьте той самий passphrase у Freya, коли додаєте ключ OKX. Binance і Bybit passphrase не використовують.
Чи можу я підключити більше ніж одну біржу?
Так. Ви можете додати API-ключі для Binance, OKX і Bybit, а також керувати ними чи видаляти їх будь-коли через Налаштування → API-ключі.
Чи безпечно давати Freya свій API-ключ?
Так, якщо ключ налаштовано правильно — лише читання та торгівля, без виведення, і з білим списком IP там, де це можливо. Ваші кошти залишаються на вашій власній біржі, а ключ, яким ви ділитеся, не може їх перемістити. Повне пояснення — у статті «Чи безпечні мої гроші на Freya Finance?».
Які біржі підтримує Freya?
Наразі Freya підключається до Binance, OKX і Bybit (спот та ф'ючерси). З часом можуть додаватися й інші біржі. Ви торгуєте на тій із них, яку підключили, — ваші кошти та доступні ринки залишаються на цій біржі.
Якими монетами чи торговими парами я можу торгувати?
Доступні пари беруться з лістингу вашої підключеної біржі, а не з окремого списку Freya, — тож якщо ваша біржа має пару в лістингу (наприклад, BTC/USDT, ETH/USDT), ви можете побудувати на ній бота. Більшість торгівлі ведеться проти USDT як валюти котирування. Якщо біржа знімає пару з лістингу, вона перестає бути доступною для торгівлі там.