К руководству
Разделы сайта

BYBIT GLOBAL SPOT · GUIDE 01

Как создать и настроить API-ключ Bybit

Ваш аккаунт. Отдельный ключ. Только необходимые права. Практическое руководство для Bybit Global Spot: от API Management до проверки подключения в TradeMatic.

TradeMaticОпубликовано и проверено 11 мин чтения

Краткий ответ

API-ключ Bybit позволяет приложению читать разрешённые данные аккаунта, а при наличии торговых прав — отправлять заявки. Ключ создают в веб-разделе управления API с двухфакторной аутентификацией и минимально необходимыми разрешениями. TradeMatic использует системный HMAC-ключ Bybit Global MAINNET Spot и аккаунт UTA 2.0: чтение и запись, SpotTrade, без вывода средств и переводов.

Вы получите API Key и API Secret. Оба значения чувствительны; секрет служит для подписи запросов. Не публикуйте его в переписке, коде или скриншотах. На этой странице нет формы для ввода ключей.

  1. Проверьте аккаунт и двухфакторную аутентификацию.
  2. Создайте системный ключ в API Management.
  3. Разрешите только нужную спотовую торговлю и привяжите правильный IP.
  4. Подтвердите создание и выполните шаги /settings в настоящем боте.
  5. Проверьте подключение и отдельно решите, разрешать ли торговлю.

Что понадобится перед началом

Используйте собственный аккаунт, доступный вам по правилам вашей юрисдикции. Проверьте актуальные требования Bybit к верификации и доступность сервисов. Не обходите региональные ограничения. Аккаунт Bybit EU или другой региональной платформы не становится совместимым с этой интеграцией Global автоматически. Подготовьте Google Authenticator либо способ подтверждения, который требует ваш аккаунт.

Для создания используйте веб-браузер на компьютере или телефоне: стандартный путь в мобильном приложении в официальной инструкции не предусмотрен. Для новых аккаунтов возможно ограничение первых 48 часов. Mainnet, Testnet и Demo — разные окружения с отдельными ключами. Тестовый ключ не подойдёт для подключения этого продукта к реальному рынку.

Доступ к API не заменяет средства для торговли. Торговые комиссии удерживает Bybit при исполнении сделок. Подписка TradeMatic даёт доступ к сервису; перед подключением ознакомьтесь с условиями подписки.

Нет аккаунта Bybit?ЗарегистрироватьсяРеферальная ссылка

Пошаговое создание ключа

Последовательность сверена с официальной инструкцией Bybit. Названия могут отличаться из-за языка, региона или обновления интерфейса. Вход в пользовательский аккаунт для этой статьи не выполнялся; изображения ниже — поясняющие схемы, а не скриншоты.

  1. Откройте настоящий сайт Bybit и войдите

    Проверьте домен перед вводом пароля. После входа откройте API Management. Это прямая ссылка в настройки, а не реферальная регистрация.

  2. Найдите раздел API

    Перейдите к управлению API из меню профиля. Если ссылка без авторизации вернула на главную, сначала войдите и откройте нужный раздел в аккаунте.

  3. Нажмите Create New Key

    Создайте отдельный ключ для TradeMatic. Не меняйте разрешения ключа другого приложения ради сокращения настройки.

  4. Выберите системный тип ключа

    System-generated использует HMAC и выдаёт пару API Key / Secret. Self-generated использует собственную пару RSA. Текущий путь подключения TradeMatic RSA не поддерживает.

  5. Задайте понятное имя и назначение

    Например, «TradeMatic Spot». Выберите путь API-транзакций, если он показан. Не ищите TradeMatic в списке сторонних приложений без подтверждения такой интеграции.

  6. Укажите минимальные права

    Для торговли нужны чтение/запись и разрешение Spot, описанные ниже. Read-only может успешно читать данные, но не позволяет выставлять торговые заявки.

  7. Ограничьте доступ по IP

    Используйте актуальный адрес, который TradeMatic сообщает лично через /settings. IP вашего компьютера или адрес сайта для этого не подходят автоматически.

  8. Подтвердите действие через 2FA

    Пройдите проверку Bybit. Не отправляйте поддержке TradeMatic код аутентификатора, пароль аккаунта или фразу восстановления.

  9. Сохраните показанные данные безопасно

    Следуйте указаниям Bybit. Подойдёт менеджер паролей или другое зашифрованное хранилище секретов. Не рассчитывайте, что секрет можно будет снова показать позже.

  10. Перепроверьте параметры перед подключением

    Сверьте окружение, права, IP и срок действия в API Management. Затем продолжайте в настоящем боте, а не в форме на этом сайте.

Схема: профиль, API Management, новый ключ и системный тип HMAC
Оригинальная поясняющая схема, не скриншот интерфейса Bybit. Шаги 1–4.

Какие разрешения нужны TradeMatic

Чтение/запись и SpotTrade — две отдельные проверки. Параметр readOnly не заменяет разрешение Spot: оба должны соответствовать торговому подключению. Состав полей приведён в официальном описании API-ключа.

РазрешениеНужно?Для чего
Чтение необходимых данныхДаРежим аккаунта, баланс, комиссии, состояния ордеров.
Чтение/запись + SpotTradeДа, для торговлиСобственные BUY и связанные лимитные SELL на Spot.
WithdrawНетДля работы бота вывод средств не нужен.
Переводы между аккаунтамиНетИнтеграция не требует прав перевода.
Деривативы / фьючерсыНетЭто подключение только для Spot.
Маржа / кредитное плечоНетЗаявки создаются без заёмного плеча.
P2P / фиат / PayНетК подключению не относятся.

Как настроить IP whitelist Bybit

Whitelist ограничивает адреса, с которых можно использовать ключ. Биржа видит публичный исходящий IP торгового сервера, а не обязательно вашу домашнюю сеть. NAT, прокси и смена хостинга могут менять адрес выхода. IP сайта сам по себе не доказывает, что торговые запросы идут оттуда.

Возьмите актуальный адрес из /settings. Инфраструктурные IP в этой статье не публикуются. Если адрес не указан однозначно либо Bybit его отклоняет, уточните значение у официальной поддержки без передачи секрета. Не копируйте случайные IP из других инструкций и не снимайте ограничение как обычный способ ремонта.

При смене исходящего IP подписанные запросы могут перестать проходить. Проверьте ограничение в API Management, убедитесь, что настраиваете тот же ключ, и повторите штатную проверку подключения. Успешное чтение баланса подтверждает возможность чтения, но не все торговые права.

В официальном API FAQ Bybit указан срок 90 дней для ключей без IP-привязки. Фактическую дату смотрите в аккаунте. Нельзя обещать бессрочную работу ключа с IP: изменения безопасности аккаунта тоже могут влиять на его действительность.

Схема: чтение и Spot, IP сервера, подтверждение 2FA и защита секрета
Поясняющая схема, не настоящая форма настроек. Шаги 5–7: права, IP и защита ключей.

Как обращаться с API Key и API Secret

API Key идентифицирует ключ, API Secret подписывает HMAC-запросы. Защищайте оба значения. Используйте отдельный ключ для сервиса, защищайте Telegram-аккаунт и избегайте общих скриншотов, истории буфера обмена и недоверенных расширений браузера. Не помещайте ключи в адресную строку.

Вводите данные только по запросу /settings в личном чате настоящего @TradeMaticBot. Бот пытается удалить сообщения с ключами, но гарантировать удаление нельзя. Не передавайте API Secret сотрудникам поддержки или другим ботам.

Как подключить ключ к TradeMatic

Откройте @TradeMaticBot по ссылке с сайта. Пройдите начальные шаги, выбор языка и принятие условий. Для /settings требуется действующая подписка либо уже предоставленный доступ. Предварительно запускать торговлю ради настройки ключей не нужно.

  1. Откройте /settings в личном чате.
  2. При первом подключении выполните показанный выбор пары.
  3. Последовательно введите API Key, затем API Secret по соответствующим запросам. Для выхода из настройки используйте /cancel.
  4. Дождитесь проверки ключа, режима аккаунта, прав и соединений. Если проверка не пройдена, ориентируйтесь на конкретную причину.
  5. Проверьте пару, сумму BUY в USDT, процент падения, параметры продажи и задержку. Команда /balance показывает доступные и заблокированные средства.

Для торговли используется поддерживаемый аккаунт UNIFIED, а не просто наличие средств в Funding. Нулевой баланс может быть корректным результатом чтения. Недостаточные права не исправляются пополнением депозита.

Схема: настоящий личный бот, settings, пара, API Key, API Secret и проверки
Поясняющий путь сверён с текущим кодом продукта; это не скриншот и не живая сессия бота.

Проверка подключения без тестовой сделки

Прочитайте результат в /settings. Сверьте Global MAINNET, свой аккаунт и пару, режим UTA 2.0 и фактическое разрешение Spot. Публичная цена не доказывает приватную авторизацию, а открытый private socket сам по себе не подтверждает подписки.

Проверьте чтение через /balance. Затем отдельно решите, хотите ли отправить /start. Эта статья не создаёт ордеров, не включает RUN и не подключает ключи за вас. Сначала прочитайте описание алгоритма и риски торговли.

Частые ошибки настройки API

Коды сверены с официальным списком Bybit; бот может показывать очищенное название. Не заменяйте конкретную ошибку общим выводом «ключ неправильный».

ОшибкаЧто проверить и сделать
API Key Invalid · 10003Проверьте копирование и соответствие Global/Mainnet, Testnet, Demo или региональной платформе. Повторный ввод — только через /settings; неясное окружение уточните у поддержки.
Invalid Signature · 10004Нужна совпадающая пара системного HMAC-ключа и секрета. Если скопировано верно, сообщите поддержке: ошибка подписи или часов не требует расширения прав.
Permission Denied · 10005Проверьте чтение/запись и SpotTrade. Не добавляйте вывод, фьючерсы или переводы. Если нужные права уже есть, обратитесь в поддержку.
IP Address Not Allowed · 10010Сверьте актуальный адрес из /settings с whitelist. Смену адреса уточняйте у поддержки; не отключайте защиту как стандартное решение.
Account Type MismatchПроверьте Global MAINNET и поддерживаемый UTA 2.0. Баланс в другом разделе аккаунта не доказывает совместимость режима.
API Key Expired · Spot -2015Посмотрите срок и изменения безопасности в API Management. Продлите или замените ключ штатным способом Bybit.
Rate LimitСоблюдайте указанный cooldown. Частые повторы и сохранения могут усугубить ограничение. Если оно не проходит после ожидания, сообщите время и ошибку.
Network / API UnavailableПроверьте официальные сообщения о доступности и повторите позже. Не отправляйте поддержке секреты или подписанные запросы.
Не получается создать ключПроверьте 2FA, верификацию, веб-интерфейс и возможные первые 48 часов. Ограничения аккаунта уточняйте у Bybit.
Ключ создан, но бот не принимаетОтдельно проверьте HMAC, окружение, UTA, доступ к подписке, согласия, права и IP. Поддержке нужны очищенная ошибка и время, а не API Secret.

Что делать при возможной утечке

Запретите новые входы командой /stop и незамедлительно отзовите ключ в API Management Bybit. Остановка бота и отзыв ключа на бирже — разные действия. В веб-списке ключей выберите удаление и подтвердите его.

Проверьте ордера, исполнения и активность аккаунта. При подозрении на взлом основного аккаунта выполните рекомендации Bybit по его защите. Создайте новый отдельный ключ с минимальными правами и замените его через /settings. Отзыв ключа не следует считать отменой стоящих ордеров или возвратом уже совершённых сделок.

Частые вопросы

API Bybit бесплатный?

В официальном процессе Bybit нет отдельной покупки API-ключа. Биржевые комиссии сохраняются, а подписка TradeMatic оплачивается отдельно. Проверяйте текущие комиссии и лимиты биржи.

Можно создать ключ с телефона?

Используйте сайт Bybit в браузере. Официальная инструкция не предусматривает стандартный путь через мобильное приложение; на компьютере удобнее проверять права.

Нужны ли права вывода средств?

Нет. Для этой спотовой интеграции не требуются ни Withdraw, ни переводы между аккаунтами.

Можно потерять деньги без права вывода?

Да. Торговые права позволяют совершать убыточные, несанкционированные или неподходящие сделки. Запрет вывода не гарантирует безопасность и прибыль.

Что такое IP whitelist?

Это список разрешённых адресов отправителя. Возьмите актуальный адрес торгового сервиса лично из /settings, а не IP своего ПК или пример из другой статьи.

Почему истекает срок API-ключа?

Bybit указывает 90 дней для ключей без IP-привязки. Смотрите реальный срок и изменения безопасности в аккаунте; ключ с IP нельзя считать бессрочным.

Можно использовать ключ в нескольких приложениях?

Лучше отдельный ключ для каждого сервиса. Общий ключ усложняет отзыв, ограничения IP, разбор лимитов и расследование неожиданной активности.

Как отозвать API-ключ?

Откройте API Management на сайте Bybit, выберите удаление нужного ключа и подтвердите. Отдельно остановите новые входы бота и проверьте стоящие ордера.

Ввод ключей сразу запускает торговлю?

Новая остановленная сессия остаётся остановленной. Действующий RUN может продолжиться после замены ключа того же UID; /start — торговое поручение. Для запрета входов используйте /stop.

Что делать, если подключение не проходит?

Следуйте конкретной ошибке в /settings и проверкам выше. Поддержке @TradeMaticAdmins передавайте время и очищенную ошибку, никогда API Secret.

Официальные источники

Источники проверены 6 ноября 2026. Интерфейс может меняться; ориентируйтесь на актуальные подписи и официальные требования вашего региона.