# ByBit

Криптобиржа — тикеры, баланс, ордера, позиции, свечи

## Сценарии

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

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

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

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

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

### Войдите в кабинет Bybit и откройте управление API
Войдите под тем аккаунтом, на котором лежат средства, и откройте страницу «API Management» — www.bybit.com/app/user/api-management. Ключ суб-аккаунта видит только его собственный баланс и сделки.

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

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

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

### Скопируйте API Key и Secret
Сразу после создания скопируйте оба значения — API Key и Secret. Secret хранится только на вашей стороне: если он потерян, ключ придётся удалить и создать заново.

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

### Как подключить ByBit?
Ключом 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».

[Открыть ByBit](https://www.bybit.com/app/user/api-management)