Hummingbot Setup
You can take advantage of IDEX's lightning speed by setting up a trading bot. In this guide we'll show you how to run Hummingbot on IDEX.
Last updated
Was this helpful?
You can take advantage of IDEX's lightning speed by setting up a trading bot. In this guide we'll show you how to run Hummingbot on IDEX.
Last updated
Was this helpful?
is an open source software that helps you build market making and arbitrage bots.
We strongly recommend checking out Hummingbot's documentation here:
In this guide we'll show you how to install Hummingbot on a virtual machine (for optimum up-time, reliability). You can also do this on your own computer (or server) with Ubuntu 16.04 or later.
Now we'll configure the specifications of the virtual machine we'll be using to run Hummingbot. We recommend using Ubuntu 20.04 LTS, a Basic plan, 1 CPU and 2GB of ram for installing Hummingbot.
Click on [Create Droplet] to launch your virtual machine.
Once your virtual machine has been created, you can click on its menu (or the 3 dots on the top-right side) then select "Access Console" to open a terminal to your virtual machine.
A new window will open. It will be connected to your virtual machine. We will now add a new user by typing the following command:
Now we'll add the newly created account to our sudo group by typing in the following:
You can close this window now.
With the basic setup out of the way, we can begin installing Hummingbot in your virtual machine. To accomplish this, you'll connect to it from your computer. We will use the "Command Prompt" (Windows) or "Terminal" (macOS).
A new window will open now, looks like this:
Once you're on windows command prompt, you must enable copy pasting by right clicking the title bar and selecting Properties as shown above.
Tick the option "Use Ctrl+shift C/V as copy paste" as shown above then click [OK].
Before we continue its also important that you write down your virtual machine's IP address:
Now we'll connect to the virtual machine we created at Digital Ocean via SSH by running:
You'll be asked if you want to "continue connecting". Type the word "yes" and hit Enter.
Once you're connected to your virtual machine then you should see your its username and host name on the terminal (as shown above).
Now we can begin installing Hummingbot by cloning the IDEX-Hummingbot repository from github by running:
Next, we will open the Hummingbot directory using the cd command:
Now we must switch to the "Silverton" branch to use with IDEXv3 (Polygon) by running:
Once you've successfully switched to the Silverton branch then you should see "Switched to a new branch idex/devAktech-v3-silverton" as shown here:
Now you can update your dependencies by running the following commands:
Next, we type the following command:
Then we must install "miniconda3" by running:
Now the following command:
You will be asked to accept the license terms for miniconda3. Be sure to answer "yes" on all options.
You will be asked for an install location, just press the enter key to install miniconda on the default location.
Once the installer is finished, you'll be asked to initialize Miniconda3. Type "Yes" and hit enter to continue
Once we have finished installing miniconda3 then we can update .bashrc to register conda by running:
Now we'll install the Hummingbot modules with:
Activate environment and compile code with:
Once it's done compiling then we can start Hummingbot by running:
You've finished installing Hummingbot on your virtual machine.
Make sure to accept the terms and conditions of Hummingbot and don't close the command prompt window.
Once you're logged in to your API account then you will be able to generate your API key by pressing the "Generate new API key" button.
Once your API key is created then check the "Read" and "Trade" options to allow trading with your API key via Hummingbot. Click [Save] and copy the API key and Secret as you'll need them shortly.
Now back to Hummingbot you can connect to the IDEX by running:
Now you'll be asked to copy your IDEX API key, API secret and your wallet private key.
Congratulations! You've successfully set up Hummingbot to run on IDEX. From this point forward, you need to configure the trading strategy your bot will run on your behalf. In the next steps we'll provide you with a couple of examples.
Hummingbot is a powerful, professional trading tool. If used incorrectly it could lead to financial losses. and understand the limits of your own trading strategies before committing funds to use this software on IDEX. IDEX is not responsible for any losses incurred when running this software.
We'll begin by creating an account at by clicking on [Sign Up] at the top-right corner of the website. Digital Ocean is a paid service so there will be monthly costs involved.
You may downgrade your virtual machine to $5/mo AFTER successfully installing Hummingbot as the extra CPU power is only required for the initial installation. Here's how to do so:
First we'll need an API key from IDEX. You can sign up for API keys under the "?" icon on the top right of our website () then to "API keys" and create a new account or Login with your existing details.
We strongly suggest you read Hummingbot's official documentation on
Hummingbot is a powerful, professional trading tool. if used incorrectly it could lead to financial losses. and understand the limits of your own trading strategies before committing funds to use this software on IDEX. IDEX is not responsible for any losses incurred when running this software.
