API-ключи Exchange Account
Дополнительный API-ключ позволяет подключить сторонний сервис к вашему Exchange Account на Bybit. Вы определяете, какие данные и действия ему доступны. Для обычной работы Exchange Account внутри ITradingBot создавать такой ключ вручную не требуется.
Эта страница относится к ключам уже созданного Exchange Account. Подключение собственного аккаунта Bybit или Binance описано в выборе способа подключения.
Выберите аккаунт
В переключателе бирж в шапке панели выберите нужный Exchange Account.
Откройте Аккаунт → API-ключи или страницу API-ключей.
Проверьте имя выбранного аккаунта и UID аккаунта. Создание и изменение ключей будут относиться к нему.
Если аккаунта ещё нет, начните со статьи Exchange Account: создание и устройство. При статусе «Создаётся» дождитесь подготовки. При «Подключается» управление ключами уже может быть доступно. При приостановленном доступе ориентируйтесь на сообщение страницы; создание, изменение и удаление могут быть недоступны.
В разделе Ключи субаккаунта отображаются дополнительные ключи. Служебные ключи ITradingBot здесь не показываются. У каждого ключа видны доступ, права, IP-адреса и даты. Если рядом с числом ключей стоит «+», загружен ещё не весь список — используйте Показать ещё.
Создайте ключ
Нажмите Создать ключ.
При желании заполните Название API-ключа, чтобы отличать его от остальных, например названием подключаемого сервиса. Позже изменить это название через форму нельзя.
Выберите Доступ, отметьте необходимые Права и заполните IP-адреса, если сервис предоставил их для привязки ключа.
Нажмите Создать ключ в форме и пройдите подтверждение безопасности предложенным способом.
Создание, изменение и удаление ключа требуют подтверждения одним из настроенных способов защиты: PIN-кодом, приложением-аутентификатором или ключом доступа. Настройка описана в статье Защита аккаунта и сессии.
Настройте доступ, права и IP
Только чтение выбрано по умолчанию. Такой ключ предназначен для получения данных в пределах выбранных прав. Чтение и торговля разрешает также изменяющие действия в выбранных группах. В зависимости от прав это могут быть ордера, работа с позициями или переводы между кошельками.
Нужно выбрать хотя бы одну группу. Отмечайте только то, что требуется подключаемому сервису:
Контракты: ордера и позиции — работа с ордерами и позициями контрактного рынка.
Спот-торговля — операции спотового рынка.
Кошелёк: переводы — переводы между кошельками этого субаккаунта, например «Финансирование» и «Единый». Эта группа не даёт вывода на внешние адреса или перевода между разными субаккаунтами.
Опционы и Деривативы (единый аккаунт) — соответствующие торговые права Bybit.
История конвертаций — просмотр истории обменов.
Earn — работа с продуктами Bybit Earn в рамках доступности для этого аккаунта.
Кнопка информации рядом с группой поясняет её назначение. Галочка не отменяет ограничение «Только чтение» и не гарантирует доступность любого продукта Bybit или совместимость с любым сторонним сервисом. Права внешнего вывода в этой форме не предоставляются. При этом торговые права тоже позволяют совершать действия с финансовым результатом, включая убытки.
IP-адреса ограничивают, откуда сервис сможет обращаться с ключом. Укажите адреса, которые сервис сообщил именно для такого подключения, через запятую. Пустое поле означает отсутствие привязки к IP. Для таких ключей действуют дополнительные ограничения и срок действия со стороны Bybit.
Проверяйте поле Действует до в карточке. Надпись «Неограниченный» относится к отображаемому сроку и не обещает, что ключ всегда будет работать независимо от отзыва, прав, IP или состояния аккаунта.
Сохраните ключ и секрет
После успешного создания откроется окно Сохраните ключ и секрет с двумя отдельными значениями: API-ключ и API-секрет.
Скопируйте оба значения и сохраните их в защищённом месте, затем укажите в соответствующих полях выбранного стороннего сервиса. Не передавайте секрет в переписке или поддержке и не размещайте его на скриншотах. Когда данные сохранены, нажмите Я сохранил ключ и секрет.
Секрет показывается один раз. После закрытия окна или перезагрузки страницы получить его из списка ключей нельзя. Сам API-ключ остаётся виден в карточке, но он не заменяет секрет. Если секрет потерян, потребуется новый ключ; ненужный старый ключ удалите после проверки, какие сервисы им пользуются.
Измените существующий ключ
В карточке нажмите Изменить. Можно поменять режим доступа, группы прав и IP-адреса. Нажмите Сохранить и подтвердите действие способом защиты аккаунта, затем проверьте обновлённую карточку.
Форма заменяет права и список IP указанными значениями. Снятая группа перестаёт передаваться как разрешённая; пустое поле IP снимает прежнюю привязку. Это может изменить или прекратить работу сервиса, который использует ключ. Название ключа и секрет через эту форму не меняются; секрет повторно не показывается.
Если у старого ключа есть предупреждение о неподдерживаемом разрешении, проверьте необходимые права и сохраните настройки: неподдерживаемые разрешения исключаются из нового набора. Не считайте старый ключ уже ограниченным только потому, что это право отсутствует среди доступных галочек.
Удалите ненужный ключ
Нажмите Удалить в карточке. В окне подтверждения сверьте название и сам ключ, нажмите Удалить ключ и пройдите подтверждение безопасности.
После успешного отзыва ключ перестаёт работать, а использующие его сервисы теряют доступ. Отмена этой операции не предусмотрена: для нового подключения создайте другой ключ.
Отзыв ключа — не команда отмены ордеров или закрытия позиций. Не считайте его остановкой всей торговли: проверьте оставшиеся ордера, позиции и другие подключения отдельно. Сам Exchange Account этой кнопкой не удаляется.
Если действие не завершилось
Кнопка недоступна. Проверьте выбранный аккаунт, его состояние, загрузку списка, соединение и сообщение страницы. Пока результат предыдущего действия не установлен, новые изменения могут быть заблокированы.
Биржа отклонила запрос. Проверьте выбранные права, формат и актуальность IP-адресов. При ограничении частоты запросов подождите указанное в панели время. Дополнительные права без понимания причины ошибки не включайте.
Результат неизвестен. После обрыва соединения ключ мог быть создан, изменён или удалён. Дождитесь перечитывания списка и проверьте его перед повтором. Если новый ключ появился, а секрет не был получен, повторно раскрыть секрет нельзя.
Если состояние не прояснилось, напишите в поддержку ITradingBot. Передайте название аккаунта, выполнявшееся действие и текст ошибки без API-секрета, паролей и кодов подтверждения.