IMPORTANT
Bybit accounts now use Unified Trading Account (UTA) by default.
3Commas supports Bybit UTA for Spot, USDT Perpetual, and Inverse Perpetual trading.
Bybit EU accounts cannot be connected to 3Commas via Fast Connect or API keys. If you want to keep using 3Commas bots with Bybit, use a supported exchange account listed here.
3Commas does not support Portfolio Margin type of accounts on Bybit.
If Portfolio Margin is enabled on your Bybit account, you will not be able to connect it to 3Commas.
To enable connectivity, you must disable Portfolio Margin in your Bybit settings.
For Bybit UTA accounts, Cross and Isolated margin modes must be changed on Bybit. These settings cannot be changed in 3Commas.
Please don't use sub-accounts with UTA Pro turned on, as it may result in an error like Error placing base order: OrderLinkedID is duplicate. This error does not occur with standard UTA sub-accounts connected.
If you see a $0 balance or missing funds in 3Commas, your funds may be in your Bybit Funding account instead of your Unified Trading Account (UTA). Check your wallets on Bybit and transfer the funds to Unified Trading, then refresh your balance in 3Commas.
For Bybit, Hedge Mode must be enabled on the exchange side and cannot be changed in 3Commas.
Bybit USDT-M:
DCA Bots: Hedge Mode is supported and optional. Multi-pair DCA bot trading is supported.
Grid Bots: Bots can operate in either Hedge Mode or One-Way Mode.
Signal Bot / SmartTrade: Hedge Mode is supported.
Terminal: Hedge Mode is not supported.
Bybit Inverse Perpetual: Hedge Mode is not supported on the exchange side.
I. Fast Connect.
This is the recommended way to connect Bybit to 3Commas.
It works with Bybit UTA accounts. To learn more about the Unified Trading account (UTA), please read this article.
1. Log into 3Commas and Bybit accounts.
Log in or create a new account at https://www.bybit.com/.
2. Before we continue, please ensure you don't have active API keys created with Fast Connect.
You can go to the API Management page and delete old API keys created manually or by Fast Connect (this eliminates any possible errors while updating with Fast Connect):
3. On 3Commas, go to the My Portfolio page and click on the "Connect a new account" button.
If this is your first exchange to be connected, please click on the Connect exchange button:
4. Click on Exchanges
5. Choose Bybit:
6. Choose the Fast Connect tab and click on the Connect button
7. You are done!
All 3 types of accounts are connected:
IMPORTANT NOTE!
If you already connected the exchange to 3Commas, you will receive an error telling you to delete the old API keys and reconnect the exchange with Fast Connect.
II. Update with Fast Connect.
If you need to connect a new API key, here's what to do:
a. Remove the Existing Key: Log in to your Bybit account and manually delete the current API key.
b. Reconnect on 3Commas: Follow the steps below to reconnect your new API key.
1. Go to the My Portfolio page and find the Bybit exchange that needs to be updated.
2. Click on the Update API Key button.
or
3. Click on the Reconnect button.
4. Log into Bybit account and/or Authorize the Request.
5. Confirm the API keys creation:
Please don't change any permissions if you want to reconnect all the exchanges types:
6. Now your connection is updated:
III. Manual API keys creation.
This method can be used for Bybit UTA accounts if you prefer manual API keys instead of Fast Connect.
To learn more about the Unified Trading account (UTA), please read this article.
1. Go to Bybit
Log in or create a new account at https://www.bybit.com/.
2. Open the API dashboard
Hover over the profile icon on the top right corner, then click API:
3. Click Create New Key
Note! You must enable 2FA to be able to add API keys.
If you see this dialog, click Confirm:
Click Settings and follow Bybit's instructions to enable 2FA:
4. Choose the System-generated API Keys
5. Change to Connect to Third-Party Applications and choose 3Commas
6. Select permissions and click Submit
You need to select the following permissions:
Read-Write option;
Orders and Positions in the Contract section;
Trade in the SPOT section.
These permissions are responsible for the following markets:
Contract = Bybit Inverse Perp. market;
Spot = Spot market.
7. Enter verification codes, then click Confirm
8. Copy API Key and API Secret somewhere safe
Or just don't close this window:
Click on Understood after copy-pasting the API keys.
9. Connect the exchange to 3Commas using created API keys with the help of this article:
IV. Update with new API keys.
To update the connection with new API keys, please follow the instructions from this article:
Connecting Multiple Bybit Accounts to 3Commas
You can connect multiple Bybit accounts to your 3Commas account. Each account must meet the following:
They must be separate Bybit user accounts (not the same login reused)
You cannot connect the same Bybit account to more than one 3Commas account at the same time
If the Bybit account is already connected elsewhere (even on another 3Commas account), you will get an error
Exchange Connection Failed: This account is already connected
If you try to connect a Bybit account that is already linked to another 3Commas account (or the same account more than once), you’ll see this error. Make sure:
You are connecting a different Bybit account
The Bybit API key is not in use on any other 3Commas account
If you want to manage two Bybit accounts under one login, you can create a sub-account in Bybit and connect it using Manual API keys. Fast Connect does not support sub-accounts.
If you previously connected this account and removed it, make sure to also delete the old API keys in Bybit’s dashboard before reconnecting.