API Bybit: как перестать пялиться в монитор и доверить рутину коду

Сидишь, смотришь на график. Ждёшь, когда цена подойдёт к уровню. Час, два, три. Потом отвлёкся в гальюн — а тебя уже пролили на 6% и отскочили. Было?

Ручная торговля — это прям работа. Особенно если торгуешь не один инструмент, а мониторишь сразу пяток альтов или ждёшь конкретную точку входа по уровню. Глаза в кучку, спина болит, а профита — с гулькин нос.

У меня та же беда была ровно до того момента, пока я не подружился с API Bybit. Сейчас объясню, зачем оно нужно, как настраивается и почему даже базовый скрипт на Python может сэкономить тебе ведро нервов и пару лет жизни.

Зачем трейдеру Bybit API

API — это как пульт управления от биржи, только без кнопок «включить» и «выключить». Через API ты можешь дёргать биржу командами из кода: выставлять ордера, отменять их, получать информацию о балансе, позициях, историю сделок. Всё, что доступно в веб-интерфейсе или приложении, доступно и через API.

Главный профит: автоматизация. Алготрейдинг, торговые боты, сбор статистики, оповещения в Telegram, копитрейдинг с витрины — всё это работает через API.

Я для себя закрыл три сценария:

• Ловля просадок на споте по сеточному боту. Накидал лимиток с шагом в 1% и ушёл спать. Утром либо всё исполнилось, либо я в плюсе;
• Сбор исторических данных для бэктеста. Вручную скачивать свечки по 15 парам — это пытка. Пара строчек кода на Python — и у тебя CSV с 10 тысячами строк;
• Страховочный стоп-лосс. Бывает, ордер поставил, а цена чуть не дошла и улетела в другую сторону. Скрипт может отслеживать движение цены и передвигать стоп.

При этом доступ к API даёт биржа, он бесплатный. Ограничения есть только по частоте запросов, но для частника их хватает за глаза.

Где взять API-ключ Bybit и как его не слить в паблик

Вопрос, с которого начинаются все проблемы новичков. Открываешь настройки аккаунта, видишь раздел API и думаешь:

«О, ща натыкаю галочек и скопирую ключи в Телеграм-бота, которого нашёл в описании под видосом на Ютубе».

Остановись.

Где взять API-ключ Bybit — полдела. Важнее — понимать, какие права ты ему выдаёшь. Потому что если дать разрешение на вывод средств левому скрипту, депозит может уехать в закат быстрее, чем ты успеешь сказать «блокчейн необратим».

Пошагово: как создать API-ключ на Bybit

Интерфейс у биржи меняется редко, но логика одна. Держи актуальный маршрут:

1. Заходишь на bybit.com, логинишься. Сверху справа наводишь на иконку профиля;
2. В выпадающем меню выбираешь «API» или «API-управление»;
3. Жмёшь «Создать новый ключ». Система попросит ввести код двухфакторной аутентификации (Google Authenticator или СМС);
4. Выбираешь тип ключа: «API-транзакции» (для торговли) или «Только чтение» (для получения информации). Я для ботов беру транзакционный, для сбора данных — read-only;
5. В настройках разрешений обязательно сними галку с «Вывод средств» (Withdraw), если она стоит. Ни один твой скрипт не должен иметь права выводить деньги. Это аксиома;
6. Опционально: привяжи IP-адрес. Если торгуешь с сервера, укажи его статический IP. Тогда даже при утечке ключа злоумышленник с другого адреса не сможет ничего сделать;
7. Копируешь API Key и Secret Key. Секретный ключ показывается только один раз! Сохрани его в менеджере паролей, в зашифрованной заметке, где угодно, только не в открытом чате.

Всё. Ключ создан. Теперь он отображается в списке API-ключей, где его можно в любой момент удалить или изменить разрешения.

Важно! Куда не надо вставлять API-ключ Bybit

• Сторонние Телеграм-боты с обещанием «иксов». 99% из них просто стырят твой ключ и уведут депозит;
• Пиратские терминалы и «крякнутый» софт. Либо там зашит стиллер, либо код настолько кривой, что сам случайно сольёт баланс;
• Скрипты с GitHub, которые ты не читал. Даже если автор известный, всегда проверяй, что именно код отправляет на биржу.

Лайфхак: всегда создавай отдельный субаккаунт для экспериментов с API. Переводи туда минимальную сумму, тестируй логику, и только потом подключай к основному счёту.

Использование Bybit API с Python: пишем первого бота за 15 минут

Python — язык номер один для криптоавтоматизации. Библиотек вагон, документация живая, порог входа низкий. Использование API Bybit с Python сводится к установке официального SDK и паре десятков строк кода.

Я покажу минимальный рабочий пример, который выставляет лимитный ордер на покупку BTC по цене на 5% ниже текущей и ставит стоп-лосс. Не жди грааля — это скелет, который можно обвешивать логикой.

Установка и первый запрос

Ставим библиотеку pybit. Она поддерживается самой Bybit и обновляется под новые версии API (сейчас актуальна v5).

pip install pybit

Дальше — код. Никакой магии.

from pybit.unified_trading import HTTP
import time

session = HTTP(testnet=True) # Тестовая сеть, тренируемся без риска
# session = HTTP(api_key=»твой_api_key», api_secret=»твой_secret_key»)

# Получаем текущую цену BTC/USDT
ticker = session.get_tickers(category=»spot», symbol=»BTCUSDT»)
price = float(ticker[‘result’][‘list’][0][‘lastPrice’])
print(f»Текущая цена BTC: {price} USDT»)

Если вывод появился, соединение с API Bybit работает. Можно идти дальше.

Выставляем лимитный ордер и стоп-лосс

Задача: купить 0.001 BTC по цене на 5% ниже рыночной. Как только ордер исполнится, тут же выставить стоп-лосс на 2% ниже цены покупки.

# Расчёт цен
buy_price = round(price * 0.95, 2) # на 5% ниже
qty = 0.001

# Лимитный ордер на покупку
order = session.place_order(
category=»spot»,
symbol=»BTCUSDT»,
side=»Buy»,
orderType=»Limit»,
qty=str(qty),
price=str(buy_price)
)
print(f»Лимитник выставлен: {order}»)

# Ждём исполнения (в реальном боте лучше опрашивать статус в цикле)
time.sleep(5)
order_status = session.get_order_history(category=»spot», orderId=order[‘result’][‘orderId’])
if order_status[‘result’][‘list’][0][‘orderStatus’] == ‘Filled’:
stop_price = round(buy_price * 0.98, 2) # стоп на 2% ниже входа
stop_order = session.place_order(
category=»spot»,
symbol=»BTCUSDT»,
side=»Sell»,
orderType=»Limit»,
qty=str(qty),
price=str(stop_price),
timeInForce=»GTC»
)
print(f»Стоп-лосс на {stop_price} USDT установлен.»)

Код утрированный, но показывает логику. Для реальной торговли добавь обработку ошибок, проверку баланса, логгирование в файл и работу с вебсокетами (чтобы не дёргать REST каждую секунду).

Куда смотреть, если Bybit API не работает

Документация API Bybit — твой главный друг. Там описаны все эндпоинты, коды ошибок и лимиты. Чаще всего новички спотыкаются о три вещи:

• Неправильный timestamp. Сервер Bybit сверяет время запроса. Если часы на компе отстают или спешат больше чем на пару секунд — ошибка;
• Путаница между спотом, линейными и обратными контрактами. В pybit параметр category принимает «spot», «linear», «inverse». Перепутал — получаешь пустой ответ или ошибку;
• Неправильная подпись. Библиотека pybit делает её сама, но если пишешь свой HTTP-клиент, то нужно точно воспроизвести алгоритм из документации.

Ещё одна грабля: тестовая сеть (testnet) и боевая — разные среды. API-ключи для них не пересекаются. Создавать ключи на testnet.bybit.com нужно отдельно.

Сравнение: ручная торговля против Bybit API

Для наглядности свёл плюсы и минусы в таблицу. Без неё сложно осознать, сколько времени ты реально теряешь.

Выбор кажется очевидным. Но есть нюанс: API — это не волшебная палочка. Если твоя стратегия убыточна вручную, автоматизация ускорит слив депозита. Робот — лишь исполнитель. Мозги — твои.

Что можно автоматизировать уже сегодня

Не обязательно лезть в дебри высокочастотной торговли и писать маркет-мейкерские стратегии. Есть простые вещи, которые забирают кучу времени, но легко автоматизируются.

• Ежедневный сбор отчёта: баланс, открытые позиции, PnL за сутки. Всё это API Bybit отдаёт по одному запросу. Скрипт может формировать отчёт в Google Таблицу или присылать в Телеграм;
• Усреднение позиции сеткой лимитных ордеров. Вручную ставить 20 ордеров с шагом 0,5% — занятие для монаха. Параметризованный скрипт делает это мгновенно;
• Закрытие всех позиций одной кнопкой (panic button). Иногда нужно быстро выйти в кэш. Вместо того чтобы судорожно тыкать мышкой, жмёшь одну клавишу и скрипт выставляет рыночные ордера на продажу всего;
• Репликация сделок между аккаунтами. Если торгуешь с нескольких счетов, API позволяет дублировать сигналы без задержек.

На каждый из этих сценариев есть готовые решения на GitHub. Но даже если код чужой, всегда проверяй, не светит ли он твой Secret Key куда-то на левый сервер.

Вывод: Bybit API не для избранных, а для ленивых и умных

Ручная торговля — это спорт для тех, кому нравится процесс ради процесса. Если цель — зарабатывать, а не пялиться в терминал, API Bybit решает 90% головной боли.

Тратить вечер на то, чтобы разобраться, как создать API-ключ на Bybit и запустить простейший скрипт, — инвестиция с доходностью в сотни часов свободного времени в год. Код не тупит от недосыпа, не жмёт FOMO и не режет лося с запозданием.

Я свой выбор сделал. У меня на сервере крутятся три простых стратегии, а я в это время пишу этот текст или смотрю кино. Депозит растёт, нервы целы.

FAQ: ответы на вопросы, которые мне задавали про Bybit API

За годы работы с биржей у меня накопился небольшой архив типовых вопросов. Выношу самые частые.

Чем отличается API v3 от v5? Какую версию использовать?

Bybit планомерно переводит всех на Unified Trading API (v5). V3 ещё работает, но новые функции появляются только в v5. Рекомендую сразу начинать с пятой версии. Библиотека pybit >=2.0.0 поддерживает её из коробки.

Можно ли через API торговать фьючерсами с плечом?

Да. В запросе нужно указать category=»linear» (для USDT-контрактов) или «inverse» (для обратных). Параметры плеча устанавливаются через отдельный эндпоинт set_leverage. Всё это подробно расписано в документации API Bybit.

Я создал API-ключ на Bybit, но скрипт не видит баланс. Почему?

Скорее всего, ключ создан для основного аккаунта, а торгуешь на субаккаунте. Или наоборот. API-ключи привязаны к конкретному UID. Проверь, на каком именно счёте лежат средства и совпадает ли UID в запросах.

Безопасно ли хранить секретный ключ прямо в коде?

Нет. Категорически нет. Выноси ключи в переменные окружения (.env файл) или используй менеджеры секретов. Если код попадёт в публичный репозиторий (даже случайно), твой аккаунт скомпрометируют за минуты. Сканеры GitHub ищут API-ключи Bybit круглосуточно.

Где взять примеры использования API Bybit с Python для новичка?

Официальный репозиторий Bybit на GitHub: bybit-exchange/pybit. В папке examples есть готовые сниппеты для разных категорий. Оттуда и стартуй.

А теперь вопрос к тебе, читатель. Какая рутинная операция на бирже бесит тебя сильнее всего: выставлять однотипные лимитки, переносить стоп или мониторить новости ради выхода из позиции? Напиши в комментариях — может, в следующей статье разберу конкретно твой сценарий автоматизации.

Статью сохрани в закладки. Перешли другу, который до сих пор выставляет ордера по ночам вручную. Ему пора спать.