- API-ключ даёт программе доступ к вашему аккаунту Bybit без пароля: бот может торговать, налоговый сервис — читать историю.
- Главное правило: никогда не включайте разрешение на вывод для сторонних сервисов. Укравший такой ключ выведет деньги.
- Ключ без привязки к IP-адресу на Bybit живёт 90 дней, потом его нужно создавать заново. С привязкой к IP он бессрочный и намного безопаснее.
- Для налоговых сервисов и трекеров портфеля хватает режима «только чтение».
- Отдельный ключ — для каждого сервиса. Скомпрометирован один — удаляете только его.
Хома на связи. API звучит как что-то для программистов, но сталкивается с ним каждый, кто подключает к Bybit бота, трекер портфеля или налоговый сервис. И именно здесь происходят самые обидные потери: человек сам выдаёт программе ключ «на всё», а потом ключ утекает. Разберёмся, как делать правильно.
Сначала выберите задачу
| Задача | Разрешения | Вывод | Привязка к IP |
|---|---|---|---|
| Налоговый сервис, трекер портфеля | Только чтение | ✕ нет | желательно |
| Сторонний торговый бот или терминал | Чтение и торговля | ✕ нет | если сервис даёт свои IP — обязательно |
| Ваш собственный бот на сервере | Чтение и торговля | ✕ нет | обязательно: IP вашего сервера |
| Автоматический вывод на свой кошелёк | Вывод только на адреса из белого списка | ~ только для себя | обязательно |
Никакому стороннему сервису не нужно разрешение на вывод. Если бот, «аналитика» или «управляющий» просит ключ с выводом — это повод закрыть вкладку.
Как создать ключ
- 01Включите 2FAБез двухфакторной защиты через приложение-аутентификатор Bybit не даст создать ключ.
- 02Откройте управление APIПрофиль → API → «Создать новый ключ».
- 03Выберите тип«Системный ключ» — для своих программ и большинства сервисов. «Подключение к стороннему приложению» — если сервис есть в списке Bybit: так не нужно копировать секрет вручную.
- 04Задайте разрешенияТолько чтение или чтение и запись. Отметьте только нужные разделы: например, спот и фьючерсы. Вывод не отмечайте.
- 05Привяжите IPЕсли сервис дал список IP-адресов или у вас свой сервер — укажите их. Ключ без IP будет работать 90 дней.
- 06Сохраните ключ и секретСекрет показывают один раз. Храните его в менеджере паролей, а не в заметках и не в чате.
Почему привязка к IP так важна
| Ключ без IP | Ключ с IP | |
|---|---|---|
| Срок жизни на Bybit | 90 дней, потом ключ перестаёт работать | Без ограничения по сроку |
| Если ключ украли | Работает с любого компьютера в мире | Бесполезен: запросы принимаются только с указанных адресов |
| Удобство | Не нужен статический адрес | Нужен сервер со статическим IP или IP сервиса |
Самопроверка: насколько безопасен ваш ключ
Если ключ утёк
- 01Удалите ключПрофиль → API → удалить. Это мгновенно отключает доступ.
- 02Проверьте историюОрдера, переводы и выводы за последние дни.
- 03Смените пароль и 2FAЕсли есть подозрение, что утёк не только ключ.
- 04Создайте новый ключС привязкой к IP и минимальными правами.
Для чего обычно подключают API
- Налоги. Сервисы учёта сделок импортируют историю для декларации. Как считать налог — в статье налог на криптовалюту.
- Боты. Сеточные и DCA-боты. Но у Bybit есть встроенные боты без всякого API — разбираем их в статье торговые боты Bybit.
- Тестирование стратегий. Для этого есть отдельная тестовая среда — Bybit Testnet.
API-ключ — это ключ от квартиры, только для программы. Выдавайте минимальные права, никогда не включайте вывод для чужих сервисов, привязывайте ключ к IP и держите отдельный ключ под каждую задачу. Тогда даже утечка не превратится в потерю денег.
Частые вопросы
Как создать API-ключ на Bybit?
Профиль → API → «Создать новый ключ». Нужна включённая двухфакторная защита через приложение-аутентификатор.
Сколько действует API-ключ Bybit?
Ключ без привязки к IP — 90 дней. С привязкой к IP — без ограничения по сроку.
Нужно ли давать боту разрешение на вывод?
Нет. Для торговли достаточно чтения и записи. Разрешение на вывод сторонним сервисам не давайте никогда.
Что такое секрет API?
Вторая часть ключа, которой подписываются запросы. Его показывают один раз — сохраните сразу.
Как удалить API-ключ?
Профиль → API → удалить нужный ключ. Доступ отключится мгновенно.