Как создать API-ключ на Bybit вручную
Проще всего подключить Bybit кнопкой 🔐 Войти через Bybit — ключ создастся сам, см. Подключение Bybit кнопкой «Войти через Bybit». Ключ, созданный своими руками, нужен, например, для второго бота на том же аккаунте Bybit или если вы хотите сами выбрать права и привязку к IP. Это займёт пару минут.
Перед началом
- Ключ создаётся только на сайте Bybit — в приложении Bybit этого раздела нет. Удобнее всего — с компьютера.
- Новому аккаунту Bybit может не давать создать ключ первые 48 часов после регистрации.
- Bybit попросит подтвердить создание ключа кодом двухфакторной защиты (Google Authenticator).
- Для спота и фьючерсов нужны два разных бота и два разных ключа. Шаги для обоих одинаковые.
Названия ниже — как на английской версии сайта Bybit.
Как создать ключ
- Войдите на сайт Bybit и откройте управление API: значок профиля в правом верхнем углу → API. Прямая ссылка: https://www.bybit.com/app/user/api-management
- Нажмите Create New Key.
- В окне выбора типа выберите System-generated API Keys.
- В блоке API Key Usage оставьте API Transaction. В поле Name for the API key впишите любое имя, например
SYNC. - В блоке API Key Permissions выберите Read-Write. С ключом Read-Only бот торговать не сможет.
- Выберите ограничение по IP:
- Only IPs with permissions granted are allowed to access the OpenAPI — и впишите в поле адрес сервера SyncTrade
45.144.176.241. Рекомендуем: такой ключ бессрочный и не сработает с чужого адреса; - No IP restriction — ключ работает с любого адреса, но Bybit отключит его через 90 дней после создания. Бот заранее напомнит о замене.
- Only IPs with permissions granted are allowed to access the OpenAPI — и впишите в поле адрес сервера SyncTrade
- В таблице прав отметьте Unified Trading — эта галочка включает ордера и позиции на фьючерсах и торговлю на споте, её хватает для бота любого типа. Блоки Earn и Assets (кошелёк: переводы и вывод средств) не отмечайте. Если в списке есть права P2P — их тоже не отмечайте.
- Нажмите Submit и введите код подтверждения.
- Откроется окно Key successfully added с полями API Key и API Secret. Скопируйте оба кнопками Copy: секрет Bybit показывает только один раз, потом его не посмотреть. Нажмите Understood.
Как отправить ключ боту
- Новый бот: 🏠 Главная → 👛 Портфель → ➕ Подключить биржу → биржа → тип торговли → имя. На экране «Отправьте API-ключи текстом через пробел» пришлите одним сообщением сначала ключ, потом секрет, через пробел:
AbCdEfGhIjKlMnOpQr 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r. Бот сразу удалит это сообщение из чата. - Замена ключа у готового бота: карточка бота → 🔑 Ключи API, дальше так же.
- На сайте: Портфель → Аккаунты → Добавить аккаунт — поля API Key и API Secret, затем подтверждение в Telegram. См. Аккаунты биржи на сайте.
Эту статью открывает кнопка 📖 Как создать ключ на Bybit вручную на экранах ввода и замены ключей в боте, а на сайте — ссылка «Как создать ключ на Bybit — пошагово» в форме ключей.
Бот проверит ключ на бирже. Если ключ создан без привязки к IP, бот один раз покажет «⚠️ API-ключ без IP whitelist» с адресом сервера — это подсказка, а не ошибка.
Ограничения и допустимые значения
| Параметр | Значение | Примечание |
|---|---|---|
| Где создавать | Только сайт Bybit | В приложении Bybit раздела нет |
| Тип ключа | System-generated API Keys | — |
| Права | Read-Write и Unified Trading | Подходит и для спота, и для фьючерсов |
| Вывод средств, P2P | Не отмечать | Ключ с ними бот не примет |
| Адрес сервера для привязки | 45.144.176.241 | Ключ с привязкой к IP бессрочный |
| Ключ без привязки к IP | Действует 90 дней | Потом Bybit его отключит |
| Один ключ | Один бот | Споту и фьючерсам — по своему ключу |
| Длина ключа / секрета | 18 / 36 символов | Копируйте целиком, без пробелов |
Типовые ошибки и что бот скажет
- В приложении Bybit нет раздела API — это нормально: ключ создаётся на сайте Bybit.
- Bybit не даёт создать ключ на новом аккаунте — подождите 48 часов после регистрации.
- «Этот API-ключ создан «только для чтения». Боту нужны права на торговлю: создайте ключ с правами на ордера и позиции.» — на шаге 5 выбрано Read-Only. Создайте ключ заново с Read-Write.
- «API-ключи не имеют необходимых разрешений для работы» — не отмечена галочка Unified Trading.
- «У этого API-ключа включено право на вывод средств…» — отмечен блок Assets. Снимите право вывода в настройках ключа на Bybit или создайте ключ заново.
- «API-ключ недействителен» / «Не удалось проверить API-ключи» — проверьте, что ключ и секрет скопированы целиком, а на шаге 6 адрес вписан без ошибок:
45.144.176.241. - «Неверная длина секретного ключа: 30 символов (нужно 36)…» — секрет скопирован не целиком. Если окно с секретом уже закрыто, его не восстановить: удалите ключ на Bybit и создайте новый.
- «Такая пара API-ключей уже присутствует в системе» — этот ключ уже подключён к другому боту. Для второго бота создайте ещё один ключ.
