> 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/akkaunt/birzhevye-akkaunty/api-klyuchi-exchange-account.md).

# API-ключи Exchange Account

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

<mark style="color:$tint;">Эта страница относится к ключам уже созданного Exchange Account. Подключение собственного аккаунта Bybit или Binance описано в</mark> [выборе способа подключения](/akkaunt/birzhevye-akkaunty/vybor-sposoba-podklyucheniya.md).

### Выберите аккаунт

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

<mark style="color:$tint;">Если аккаунта ещё нет, начните со статьи</mark> [Exchange Account: создание и устройство](/akkaunt/birzhevye-akkaunty/exchange-account-sozdanie-i-ustroistvo.md). <mark style="color:$tint;">При статусе «Создаётся» дождитесь подготовки. При «Подключается» управление ключами уже может быть доступно. При приостановленном доступе ориентируйтесь на сообщение страницы; создание, изменение и удаление могут быть недоступны.</mark>

<mark style="color:$tint;">В разделе</mark> **Ключи субаккаунта** <mark style="color:$tint;">отображаются дополнительные ключи. Служебные ключи ITradingBot здесь не показываются. У каждого ключа видны доступ, права, IP-адреса и даты. Если рядом с числом ключей стоит «+», загружен ещё не весь список — используйте</mark> **Показать ещё**.

### Создайте ключ

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

<mark style="color:$tint;">Создание, изменение и удаление ключа требуют подтверждения одним из настроенных способов защиты: PIN-кодом, приложением-аутентификатором или ключом доступа. Настройка описана в статье</mark> [Защита аккаунта и сессии](/akkaunt/zashita-akkaunta-i-sessii.md).

<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 с доступом Read-only, группами прав и пустыми полями имени и 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;">— соответствующие торговые права Bybit.</mark>
* **История конвертаций** <mark style="color:$tint;">— просмотр истории обменов.</mark>
* **Earn** <mark style="color:$tint;">— работа с продуктами Bybit Earn в рамках доступности для этого аккаунта.</mark>

<mark style="color:$tint;">Кнопка информации рядом с группой поясняет её назначение. Галочка не отменяет ограничение «Только чтение» и не гарантирует доступность любого продукта Bybit или совместимость с любым сторонним сервисом. Права внешнего вывода в этой форме не предоставляются. При этом торговые права тоже позволяют совершать действия с финансовым результатом, включая убытки.</mark>

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

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

### Сохраните ключ и секрет

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

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

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

### Измените существующий ключ

<mark style="color:$tint;">В карточке нажмите</mark> **Изменить**. <mark style="color:$tint;">Можно поменять режим доступа, группы прав и IP-адреса. Нажмите</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;">Отзыв ключа — не команда отмены ордеров или закрытия позиций. Не считайте его остановкой всей торговли: проверьте оставшиеся ордера, позиции и другие подключения отдельно. Сам Exchange Account этой кнопкой не удаляется.</mark>

### Если действие не завершилось

**Кнопка недоступна.** <mark style="color:$tint;">Проверьте выбранный аккаунт, его состояние, загрузку списка, соединение и сообщение страницы. Пока результат предыдущего действия не установлен, новые изменения могут быть заблокированы.</mark>

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

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

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