# ByBit

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

## Scenarios

### Balance and open positions
The agent shows your wallet balance and every open position with its current PnL in a single answer, without you flipping between exchange tabs.

### Trades and realised PnL
The agent collects executed trades for a period and breaks the realised result down by symbol and by trade side.

### Tickers and candles
The agent pulls tickers and candles for the pairs you care about and works out how the price moved over the period you choose.

### Scheduled summary
The agent sends a summary on schedule: prices for your pairs, the change in balance and the orders still sitting unfilled.

## How to connect

### Log in to Bybit and open API management
Log in with the account that actually holds the funds and open the «API Management» page — www.bybit.com/app/user/api-management. A sub-account key only sees that sub-account's balance and trades.

### Create a «System-generated» key
Click «Create New Key» and pick «System-generated API Keys». The other option, a self-generated RSA key, will not work: requests are signed with HMAC-SHA256, so the exchange expects a key + secret pair.

### Give the key read access only
Set the key permissions to «Read-Only» — that covers balances, positions, orders, candles and trade history. The Wallet permission group, which allows transfers and withdrawals, is not needed.

### Decide on the IP restriction
A key with no IP whitelist expires after 90 days; a key bound to IP addresses does not expire. If you have no static IP, leave «No IP restriction» and set yourself a reminder to reissue the key.

### Copy the API Key and Secret
Right after creation copy both values — the API Key and the Secret. The Secret is stored on your side only: if it is lost, you have to delete the key and create a new one.

## FAQ

### How do I connect ByBit?
With an API key: in your Bybit account open API Management, then Create New Key, and pick the System-generated API Keys type — an RSA key will not work. Paste the API Key and Secret; the API address can stay at its default. Read-Only level is enough for balance, positions and history.

### What can the agent see on the exchange?
Market tickers and candles, wallet balance, open positions, orders and the executed trade history of whichever account the key belongs to.

### Can the agent trade?
Not by default: a Read-Only key covers all the analytics, and the connector never needs withdrawal rights at all. Trading permissions are granted only by your own decision on the exchange side.

### Why did my key stop working?
Without an IP allowlist a Bybit key expires after 90 days: the API starts refusing requests and the key has to be reissued under API Management.

[Open ByBit](https://www.bybit.com/app/user/api-management)