Before we start...
If you use a Portfolio Margin account, please read this information carefully!
When creating API keys, there is a choice of account - Classic or Portfolio Margin Account. If you choose a Portfolio Margin account, you may receive an error such as:
Portfolio_margin_account can only set the account CROSS_MARGIN.
The workaround for trading on a Spot account is to use a Classic Account instead of a Portfolio Margin Account.
More details about the Portfolio Margin Account you can find here.
I. Fast Connect.
1. Log into 3Commas and Gate.io accounts.
2. 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 account button:
3. Click on Exchanges and choose Gate.io.
4. Open the Fast Connect tab and click on the Connect Gate.io button
5. Approve the connection
You need to be logged in to Submit the connection:
6. You are done!
All 3 types of accounts are connected:
IMPORTANT NOTES!
You need to pass at least KYC1 to be able to connect an exchange via Fast Connect.
Make sure you have funds in your Futures account, otherwise, only the Spot account will be connected.
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.
1. Go to the My Portfolio page and find the Gate.io exchange that needs to be updates.
2. Click on the Update API Key button:
3. Click on the Reconnect button:
4. Log into Gate.io account or approve the connection:
5. Now your connection is updated:
III. Manual API keys creation.
1. Go to Gate.io
Log in or create a new account at https://www.gate.io/.
2. Open the API Management page
Hover over the profile icon on the top right corner and go to the API Management page:
3. Click on the Create API Key button
4. Name your API keys
When you have multiple APIs, a proper name helps to manage it.
5. Add IP whitelist
Enable Bind IP and input these IP addresses at once, separated by a comma.
To find updated IP addresses, go to the connecting Gate.io exchange page and take the IP addresses from there:
Copy and paste them into the IP Permissions field:
6. Choose API v4 Key and a Classic Account type
7. Select Permissions
Please select the following permissions:
[Spot/Margin Trade] -> [Read And Write] - it allows trading Spot and Margin on 3Commas.
[Perpetual Contract] -> [Read And Write] - this will allow trading Futures.
If you have an existing API Key without this enabled and you want to trade Futures, you must edit this API key or create a new key with the feature enabled before you can trade futures. Your Gate.io Contract Account must have USDT to trade USDT-Perpetual Futures or BTC to trade BTC-Perpetual futures.[Wallet] -> [Read And Write] - this is necessary to display the balances correctly.
And click on the Submit button.
8. Carefully read the Risk Reminder, tick both paragraphs, and click I Accept
9. Enter Fund Password, choose 2FA Authentication method and enter its code
10. Now, you have created API keys for your Gate.io exchange!
11. Copy and Paste the API Key and Secret to 3Commas
Follow this guide to complete linking the exchange:
REMINDER!
If you intend to trade Futures with Gate.io, please ensure you have a little BTC and/or USDT transferred to the respective BTC Perpetual and USDT Perpetual wallets before you link to 3Commas, or you may see this error message:
Before adding the API key to 3Commas, you will need to Transfer some BTC and USDT to your Perpetual Futures Account https://www.gate.io/myaccount/myfunds/futures, and only then Gate.io will allow you to add Perpetual accounts to 3Commas as well.
If BTC and/or USDT are added to your Futures Account, then not only "Gate.io Spot", but also those choices will be active for adding to 3Commas as well:
Gate.io Futures BTC Perpetual
Gate.io Futures USDT Perpetual
