ByBit
Connect ByBit to the AI agent: wallet balance, open positions, orders, candles and tickers
Connect ByBit to the AI agent: wallet balance, open positions, orders, candles and tickers. The agent reports PnL and breaks trades down by symbol.
DocumentationТри позиции открыто, суммарный нереализованный PnL +1 842 $.
- BTCUSDT, long: +2 310 $
- ETHUSDT, long: +415 $
- SOLUSDT, short: −883 $
Баланс кошелька — 24 760 $. Ещё висит неисполненный лимитный ордер по ETHUSDT.
Integration 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.
What the agent does in the first 10 minutes
- Shows your unified wallet balance and every open position with its current PnL in one answer, without switching exchange tabs
- Collects executed fills and closed PnL for a period and breaks the result down by symbol and side
- Sends a scheduled digest: prices of the pairs you care about, balance change and orders still open over the last day
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.
