ByBit

Следите за балансом и позициями Bybit прямо в чате

Подключите ByBit к ИИ-агенту: баланс кошелька, открытые позиции, ордера, свечи и тикеры. Агент покажет PnL, разложит сделки по парам и соберёт сводку.

Как агент работает с ByBit

Агент работает с единым API Bybit пятой версии: рыночные тикеры и свечи по нужным парам, баланс кошелька, открытые позиции с текущим PnL, активные ордера и история исполненных сделок. Из этого он считает закрытый результат за период с разбивкой по символу и стороне сделки, изменение баланса между датами и список заявок, которые так и висят неисполненными, — всё по аккаунту, чей ключ подключён.

У Bybit почти каждый запрос требует указать категорию рынка: спот, бессрочные контракты и опционы — это разные учётные контуры, и позиция в одном не видна в другом. Агент запрашивает категории отдельно и не смешивает их в одной сумме. Ещё одна тонкость: PnL по открытой позиции — это переоценка по текущей цене, она меняется каждую секунду, поэтому в отчётах агент отделяет её от закрытого результата по фактическим сделкам.

Читать здесь важнее, чем писать. Баланс, позиции, ордера, история и сводки по расписанию собираются одним только чтением: коннектор не переводит средства и не запрашивает прав на вывод. Торговые права появляются, только если вы сами выдали их ключу на стороне биржи; без них агент считает и показывает, но ни одной заявки не выставит и не отменит, а на попытку ответит отказом биржи, а не молчанием.

Подключение идёт парой API Key и Secret: каждый запрос подписывается HMAC-SHA256 вместе с меткой времени, поэтому часы на стороне агента синхронизированы с биржей — иначе подпись отвергается как просроченная. Историю сделок Bybit отдаёт окнами по датам и страницами по курсору, так что длинный период агент обходит частями и складывает результат сам. Частоту обращений он выдерживает сам, а об истёкшем или отозванном ключе говорит прямо, а не показывает пустую таблицу.

Сценарии интеграции

Баланс и открытые позиции

Агент покажет баланс кошелька и все открытые позиции с текущим PnL одним ответом, без переключения вкладок биржи.

Сделки и закрытый PnL

Агент соберёт исполненные сделки за период и разложит закрытый результат по каждому символу и стороне сделки.

Котировки и свечи

Агент снимет тикеры и свечи по нужным парам и посчитает, как двигалась цена за выбранный вами период.

Сводка по расписанию

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

Спот и фьючерсы порознь

Агент запросит спот, бессрочные контракты и опционы отдельными категориями и покажет баланс и позиции по каждой, не сваливая разные контуры в одну сумму.

Проверка ключа перед отчётом

Агент сделает пробный запрос по тикерам и скажет, жив ли ключ: истёк по 90-дневному сроку, отозван или подпись отвергнута — вместо пустой таблицы будет причина.

Примеры: ByBit

ByBit
Реальные диалоги — выберите вопрос
Покажи открытые позиции

Три позиции открыто, суммарный нереализованный PnL +1 842 $.

  • BTCUSDT, long: +2 310 $
  • ETHUSDT, long: +415 $
  • SOLUSDT, short: −883 $

Баланс кошелька — 24 760 $. Ещё висит неисполненный лимитный ордер по ETHUSDT.

Открытые позиции

Ответить...

Ассистент может ошибаться — проверяйте его работу

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

Перед подключением

  • Аккаунт Bybit, на котором лежат средства
  • Постоянный IP-адрес, если ключ не должен истекать через 90 дней
  1. 1

    Откройте «API Management» в кабинете Bybit

    Войдите под аккаунтом, на котором лежат средства, и откройте www.bybit.com/app/user/api-management. Ключ суб-аккаунта видит только его баланс и сделки.

  2. 2

    Создайте ключ «System-generated»

    Нажмите «Create New Key» и выберите «System-generated API Keys». Самостоятельный RSA-ключ не подойдёт: запросы подписываются HMAC-SHA256.

  3. 3

    Оставьте только права на чтение

    В правах ключа выберите «Read-Only» — этого хватает на баланс, позиции, ордера, свечи и историю сделок. Права группы Wallet на вывод выдавать не нужно.

  4. 4

    Решите вопрос с привязкой IP

    Без белого списка IP ключ истекает через 90 дней, с привязанными адресами — не истекает. Постоянного IP нет — оставьте «No IP restriction».

  5. 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».

Похожие интеграции

Категория
Банки
Подключение
По API-ключу
Документация
ByBit

Подключите ByBit

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

Попробовать бесплатно