> For the complete documentation index, see [llms.txt](https://docs.itradingbot.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.itradingbot.net/uk/oblikovyi-zapys/birzhavi-akaunt/api-kliuchi-exchange-account.md).

# API-ключі Exchange Account

<mark style="color:$tint;">Додатковий API-ключ дозволяє підключити сторонній сервіс до вашого облікового запису Exchange на Bybit. Exchange Account Ви визначаєте, які дані та дії йому доступні. Для нормальної роботи Exchange Account всередині ITradingBot створювати такий ключ вручну не потрібно.</mark>

<mark style="color:$tint;">Ця сторінка відноситься до ключів вже створеного облікового запису Exchange. Exchange Account Підключення власного рахунку Bybit або Binance описано в виборі способу підключення. —</mark> [<mark style="color:$tint;">Вибір способу підключення</mark>](/uk/oblikovyi-zapys/birzhavi-akaunt/vybir-sposobu-pidkliuchennia.md)

### Виберіть обліковий запис

1. <mark style="color:$tint;">У переключувачі бірж у шапці панелі виберіть потрібний обліковий запис Exchange. Exchange Account</mark>
2. <mark style="color:$tint;">Відкрийте</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Акаунт → API-ключі**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">або</mark> [<mark style="color:$tint;">сторінку API-ключів</mark>](https://app.itradingbot.net/api-keys)<mark style="color:$tint;">.</mark>
3. <mark style="color:$tint;">Перевірте ім'я та UID вибраного облікового запису. Створення і зміна ключів будуть відноситися до нього.</mark>

<mark style="color:$tint;">Якщо у вас ще немає облікового запису, починайте з статті обліковий запис Exchange: створення та установка. —</mark> [<mark style="color:$tint;">Exchange Account: створення та установка</mark>](/uk/oblikovyi-zapys/birzhavi-akaunt/exchange-account-stvorennia-ta-struktura.md) <mark style="color:$tint;">При стані "Створюється" чекайте підготовки. При "Підключається" управління ключами вже може бути доступним. Під час призупинення доступу орієнтуйтеся на повідомлення сторінки; створення, зміни та видалення можуть бути недоступні.</mark>

<mark style="color:$tint;">У розділі Ключі субакаунта відображаються додаткові ключі. Службові ключі ITradingBot тут не відображаються. У кожного ключа є доступ, права, IP-адреси і дати. Якщо поряд з кількістю ключів є +, завантажений ще не весь список використовуйте Покажіть ще.</mark>

### Створити ключ

1. <mark style="color:$tint;">Натисніть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Створити ключ**</mark><mark style="color:$tint;">.</mark>
2. <mark style="color:$tint;">При бажанні введіть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Назва API-ключа**</mark><mark style="color:$tint;">, щоб відрізняти його від інших, наприклад, назвою підключувається сервісу. Пізніше змінити цю назву через форму неможливо.</mark>
3. <mark style="color:$tint;">Виберіть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Доступ**</mark><mark style="color:$tint;">, позначте необхідні Дозволи і заповніть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**IP-адреси**</mark><mark style="color:$tint;">, якщо сервіс надав їх для прив'язання ключа.</mark>
4. <mark style="color:$tint;">Натисніть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Створити ключ**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">у формі і пройдіть підтвердження безпеки запропонованим способом.</mark>

<mark style="color:$tint;">Створення, зміна та видалення ключа вимагають підтвердження одним з налаштованих способів захисту: PIN-кодом, додатком-аутентифікатором або ключем доступу. Настройка описана в статті</mark> [<mark style="color:$tint;">Захист облікового запису та сесії</mark>](/uk/oblikovyi-zapys/zakhyst-oblikovoho-zapysu-ta-sesii.md)<mark style="color:$tint;">.</mark>

<figure><img src="https://1830394604-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6lHX8ZJXkBHNJALLsrDj%2Fuploads%2F4yXGuLsZgsJdo02wVwSQ%2Fexchange-api-key-form-en-20260914.jpg?alt=media" alt="Форма New API key з доступом тільки для читання, групами прав і порожніми полями імені та IP."><figcaption><p>Створення додаткового API-ключ. Доступ "тільки для читання" вибраний за замовчуванням; права ще не відмічені.</p></figcaption></figure>

### Налаштуйте доступ, права та IP

<mark style="color:$tint;">Лише читання є за замовчуванням. Такий ключ призначений для отримання даних в межах обраних прав. Читання і торгівля дозволяють також змінюючі дії в обраних групах. Залежно від прав це можуть бути ордери, робота з позиціями або перекази між гаманцями.</mark>

<mark style="color:$tint;">Треба вибрати хоча б одну групу. Зазначайте тільки те, що потрібно підключуваному сервісу:</mark>

* <mark style="color:$tint;">**Контракти: ордери та позиції**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">робота з ордерами та позиціями контрактного ринку.</mark>
* <mark style="color:$tint;">**Спот-торгівля**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">операції спотового ринку.</mark>
* <mark style="color:$tint;">Кошелек: перекази перекази між кошельками цього субакаунта, наприклад Фінансування і Одинний. Ця група не дає висновку на зовнішні адреси або перекази між різними суб-рахунками.</mark>
* <mark style="color:$tint;">Опціони та</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Деривативи (єдиний рахунок)**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">відповідні торговельні права Bybit.</mark>
* <mark style="color:$tint;">Історія конверсій перегляд історії обміну.</mark>
* <mark style="color:$tint;">**Earn**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">робота з продуктами Bybit Earn в рамках доступності для цього облікового запису.</mark>

<mark style="color:$tint;">Інформаційна кнопка поруч з групою пояснює її призначення. Значок не скасовує обмеження "тільки для читання" і не гарантує доступність будь-якого продукту Bybit або сумісності з будь-яким стороннім сервісом. Права виводу в цій формі не надаються. При цьому торговельні права також дозволяють здійснювати дії з фінансовим результатом, включаючи збитки.</mark>

<mark style="color:$tint;">**IP-адреси**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">обмежують, звідки сервіс може обробляти ключ. Вкажіть адреси, які сервіс повідомив саме для такого підключення, через запятую. Пусте поле означає відсутність прив'язання до IP. Для таких ключів діють додаткові обмеження та термін дії з боку Bybit.</mark>

<mark style="color:$tint;">Перевірте поле дійсне до в карточці. Надпис Неограничений відноситься до відображаного терміну і не обіцяє, що ключ завжди буде працювати незалежно від відклику, прав, IP або стану облікового запису.</mark>

### Зберегти ключ та таємницю

<mark style="color:$tint;">Після успішного створення відкриється вікно Зберегти ключ і секрет з двома окремими значеннями: API-ключ і</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**API-секрет**</mark><mark style="color:$tint;">.</mark>

<mark style="color:$tint;">Копіюйте обидва значення і збережіть їх у захищеному місці, потім вкажіть в відповідних полях обраного стороннього сервісу. Не розголошуйте секрет у листі або в службі підтримки, і не розміщайте його на скриншотах. Коли дані збережені, натисніть Я зберег ключ і секрет.</mark>

<mark style="color:$tint;">Таємниця з'являється один раз. Після закриття вікна або перезавантаження сторінки отримати його зі списку ключів неможливо. Сам ключ API залишається видимим на картці, але він не замінює таємницю. Якщо секрет втрачений, потрібен новий ключ; не потрібний старий ключ видаліть після перевірки, які сервіси ним користуються.</mark>

### Змінити існуючий ключ

<mark style="color:$tint;">На картиці натисніть "Змінюй". Можна змінити режим доступу, групи прав і IP-адреси. Натисніть на кнопку "</mark><mark style="color:$tint;">**Зберегти**</mark><mark style="color:$tint;">" і підтвердіть дії методом захисту облікового запису, потім перевірте оновлену картку.</mark>

<mark style="color:$tint;">Форма замінює права і список IP зазначеними значеннями. Знята група перестає передаватися як дозволена; порожнє поле IP зняває колишню прив'язання. Це може змінити або припинити роботу сервісу, який використовує ключ. Назва ключа та таємниця через цю форму не змінюються; таємниця не повторюється.</mark>

<mark style="color:$tint;">Якщо у старого ключа є попередження про непідтриманий дозвіл, перевірте необхідні права і збережіть налаштування: непідтримані дозвіли виключаються з нового набору. Не вважайте старий ключ вже обмеженим тільки тому, що це право відсутнє серед доступних галочок.</mark>

### Видалити зайвий ключ

<mark style="color:$tint;">Натисніть "Удалити" на картці. У вікні підтвердження перевірте назву і сам ключ, натисніть</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">**Видалити ключ**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">і пройдіть підтвердження безпеки.</mark>

<mark style="color:$tint;">Після успішного відкликання ключ перестає працювати, а користувачі його сервісів втрачають доступ. Відкликання цієї операції не передбачено: для нового підключення створюйте інший ключ.</mark>

<mark style="color:$tint;">Відкликання ключа не є командою скасування ордерів або закриття позицій. Не вважайте його зупинкою всієї торгівлі: перевірте залишені ордери, позиції та інші підключення окремо. Сама Exchange Account цим кнопкою не видаляється.</mark>

### Якщо дія не завершена

<mark style="color:$tint;">Перевірте вибраний акаунт, його стан, завантаження списку, підключення та повідомлення сторінки. Поки результат попереднього дії не встановлений, нові зміни можуть бути заблоковані.</mark>

<mark style="color:$tint;">**Біржа відхилила запит.**</mark> <mark style="color:$tint;"></mark><mark style="color:$tint;">Перевірте обрані права, формат і актуальність IP-адресів. Якщо ви обмежуєте частоту запитів, почекайте показаного в панелі часу. Не включайте додаткові права без розуміння причини помилки.</mark>

<mark style="color:$tint;">Після розриву зв'язку ключ міг бути створений, змінений або видалений. Зачекайте, поки перечитаєте список, і перевірте його перед повторюванням. Якщо новий ключ з'явився, а таємниця не була отримана, розкрити таємницю знову неможливо.</mark>

<mark style="color:$tint;">Якщо стан не зрозумілий,</mark> [<mark style="color:$tint;">напишіть на підтримку ITradingBot</mark>](https://t.me/ITradingBot_Support)<mark style="color:$tint;">. Передайте ім'я облікового запису, виконану дію і текст помилки без API-секрету, паролів і кодів підтвердження.</mark>