Следите за балансом и позициями Bybit прямо в чате
Подключите ByBit к ИИ-агенту: баланс кошелька, открытые позиции, ордера, свечи и тикеры. Агент покажет PnL, разложит сделки по парам и соберёт сводку.
Как агент работает с ByBit
Агент работает с единым API Bybit пятой версии: рыночные тикеры и свечи по нужным парам, баланс кошелька, открытые позиции с текущим PnL, активные ордера и история исполненных сделок. Из этого он считает закрытый результат за период с разбивкой по символу и стороне сделки, изменение баланса между датами и список заявок, которые так и висят неисполненными, — всё по аккаунту, чей ключ подключён.
У Bybit почти каждый запрос требует указать категорию рынка: спот, бессрочные контракты и опционы — это разные учётные контуры, и позиция в одном не видна в другом. Агент запрашивает категории отдельно и не смешивает их в одной сумме. Ещё одна тонкость: PnL по открытой позиции — это переоценка по текущей цене, она меняется каждую секунду, поэтому в отчётах агент отделяет её от закрытого результата по фактическим сделкам.
Читать здесь важнее, чем писать. Баланс, позиции, ордера, история и сводки по расписанию собираются одним только чтением: коннектор не переводит средства и не запрашивает прав на вывод. Торговые права появляются, только если вы сами выдали их ключу на стороне биржи; без них агент считает и показывает, но ни одной заявки не выставит и не отменит, а на попытку ответит отказом биржи, а не молчанием.
Подключение идёт парой API Key и Secret: каждый запрос подписывается HMAC-SHA256 вместе с меткой времени, поэтому часы на стороне агента синхронизированы с биржей — иначе подпись отвергается как просроченная. Историю сделок Bybit отдаёт окнами по датам и страницами по курсору, так что длинный период агент обходит частями и складывает результат сам. Частоту обращений он выдерживает сам, а об истёкшем или отозванном ключе говорит прямо, а не показывает пустую таблицу.
Сценарии интеграции
Баланс и открытые позиции
Агент покажет баланс кошелька и все открытые позиции с текущим PnL одним ответом, без переключения вкладок биржи.
Сделки и закрытый PnL
Агент соберёт исполненные сделки за период и разложит закрытый результат по каждому символу и стороне сделки.
Котировки и свечи
Агент снимет тикеры и свечи по нужным парам и посчитает, как двигалась цена за выбранный вами период.
Сводка по расписанию
Агент пришлёт сводку по расписанию: цены нужных пар, изменение баланса и заявки, которые так и висят неисполненными.
Спот и фьючерсы порознь
Агент запросит спот, бессрочные контракты и опционы отдельными категориями и покажет баланс и позиции по каждой, не сваливая разные контуры в одну сумму.
Проверка ключа перед отчётом
Агент сделает пробный запрос по тикерам и скажет, жив ли ключ: истёк по 90-дневному сроку, отозван или подпись отвергнута — вместо пустой таблицы будет причина.
Примеры: ByBit
Три позиции открыто, суммарный нереализованный PnL +1 842 $.
- BTCUSDT, long: +2 310 $
- ETHUSDT, long: +415 $
- SOLUSDT, short: −883 $
Баланс кошелька — 24 760 $. Ещё висит неисполненный лимитный ордер по ETHUSDT.
Ассистент может ошибаться — проверяйте его работу
Закрытый результат месяца +3 140 $ по 68 сделкам.
- BTCUSDT — +4 120 $
- ETHUSDT — +480 $
- SOLUSDT — −1 460 $
Считал только бессрочные контракты: спот у Bybit — отдельная категория, в одну сумму с деривативами её не свожу. Историю биржа отдаёт окнами по датам, месяц обошёл частями.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Аккаунт Bybit, на котором лежат средства
- Постоянный IP-адрес, если ключ не должен истекать через 90 дней
- 1
Откройте «API Management» в кабинете Bybit
Войдите под аккаунтом, на котором лежат средства, и откройте www.bybit.com/app/user/api-management. Ключ суб-аккаунта видит только его баланс и сделки.
- 2
Создайте ключ «System-generated»
Нажмите «Create New Key» и выберите «System-generated API Keys». Самостоятельный RSA-ключ не подойдёт: запросы подписываются HMAC-SHA256.
- 3
Оставьте только права на чтение
В правах ключа выберите «Read-Only» — этого хватает на баланс, позиции, ордера, свечи и историю сделок. Права группы Wallet на вывод выдавать не нужно.
- 4
Решите вопрос с привязкой IP
Без белого списка IP ключ истекает через 90 дней, с привязанными адресами — не истекает. Постоянного IP нет — оставьте «No IP restriction».
- 5
Скопируйте API Key и Secret
Сразу после создания скопируйте оба значения. Secret показывается один раз: если он потерян, ключ придётся удалить и создать заново.
Частые вопросы
Ключом API: в кабинете Bybit откройте «API Management» → «Create New Key» и выберите тип «System-generated API Keys» — RSA-ключ не подойдёт. Вставьте API Key и Secret, адрес API можно оставить по умолчанию. Уровня «Read-Only» хватает для баланса, позиций и истории.
Тикеры и свечи рынка, баланс кошелька, открытые позиции, ордера и историю исполненных сделок того аккаунта, чей ключ подключён.
По умолчанию нет: для всей аналитики достаточно ключа уровня «Read-Only», а права на вывод средств коннектору не нужны вовсе. Торговые права выдаются только вашим решением на стороне биржи.
Без белого списка IP ключ Bybit истекает через 90 дней: после этого API отвечает отказом, и ключ нужно перевыпустить в разделе «API Management».