BRAIN Docs
Bybit API Connection Guide
Log in to your Bybit account
Open Bybit and log in to your account. If you do not have an account yet, create one first and complete the basic security setup.
Check access to futures
Before creating an API key, open the futures trading section.
Go to: Trade → Derivatives / Futures → USDT Perpetual
Open any trading pair, for example BTCUSDT Perpetual.
If Bybit asks you to activate futures trading or accept the terms, complete this step.
Margin toggle - not required
Older versions of this guide asked you to switch on the Margin toggle in the Spot trading panel (shown below). BRAIN trades USDT-M perpetual futures only, so this is not needed - you can skip this step and leave Margin off.
Check basic account verification
Make sure that basic verification has been completed on the account if Bybit requires it for API creation or trading. The verification status can usually be found in the profile section or identity verification section.
Go to API Management
Open the profile menu and go to API / API Management.
You can also find this section by searching for API.
Create a new API key
Click Create New Key to start creating a new API key.
If Bybit offers several options, select System-generated API Keys.
Note: sometimes the Create New Key button may not respond immediately. If this happens, click it again or refresh the page and repeat the action.
Select the API key type
Select System-generated API Keys if the exchange offers several options.
Set the main API parameters
Enter the API key name, for example: BRAIN
In the settings, select:
API Transaction Write name for example “BRAIN” Read-Write Only IPs with permissions granted are allowed to access the OpenAPI
In the permissions section, enable Unified Trading.
Then tick only the Contract (futures) permissions:
- Orders
- Positions
Leave USDC Contracts, SPOT Trade, Wallet (Account Transfer, Subaccount Transfer, Withdrawal), Exchange and Earn unchecked - BRAIN trades USDT perpetual futures only, and Withdrawal must stay OFF. (The screenshot shows an older setup with USDC Derivatives and SPOT Trade ticked; they are not required.)
Copy IP addresses from Brain
Open @Brain_Trading_Bot in Telegram.
Go to: Exchanges → Bybit → Connect Bybit
Click Copy IP addresses for whitelisting.
Paste IP addresses on Bybit
Return to the API key creation page on Bybit.
Paste the copied IP addresses into the IP whitelist / IP restriction field.
After that, click Submit.
Complete security verification
Bybit may ask you to confirm the API key creation.
Confirm the action through:
- email code
- 2FA code
- SMS code, if enabled
Copy API Key and Secret Key
After creating the API, copy:
- API Key
- Secret Key
Important
Secret Key may be shown only once. Save it immediately.
After copying, click Understood.
Complete the Bybit connection in Brain
Return to Brain Mini App.
Paste:
- API Key
- Secret Key
Then click Save API Keys.
After saving, check the connection status. If everything is connected correctly, the status next to Bybit should show Connected / Active.
Bybit notes
Before creating an API key on Bybit, make sure that futures trading is already activated on your account. To connect BRAIN, the API key must be created in Read-Write mode and must have the Unified Trading - Contract permissions (Orders and Positions). If the connection does not work, check that these two are enabled and that the IP addresses for whitelisting were added correctly. SPOT Trade and Margin are not needed, and Withdrawal and internal transfers must stay OFF.