Launch Hummingbot Miner

Celo Arbitrage

Learn how to use Celo arbitrage strategies

Updated as of v0.28.1


Since Celo is a blockchain protocol, in addition to the normal inventory requirements, you will need access to a Celo node and the celo-cli command line tool in the same machine in which you are running the Hummingbot client.

Inventory of CELO or cUSD

  1. Similar to the arbitrage strategy, you will need to hold inventory of Celo tokens (i.e. Celo Gold (CELO) or cUSD) in a Celo wallet and on a secondary exchange), in order to be able to trade and capture price differentials (i.e. buy low on one exchange, sell high on the other).
  2. You may also need some CELO tokens in your Celo wallet in order to pay for transaction fees on the Celo blockchain.

Access to a Celo Node

Celo nodes allow the Hummingbot client to interact with the Celo blockchain by connecting to peers, sending transactions, and fetching chain state. Since the client just needs access to the chain and recent blocks, you can run either a Celo full node or an ultra-light node.

Follow the Celo documentation to install and run a full node. Note that the node must be synced in order for the celo-arb strategy to run.

Tip: Ultra-light sync mode — The celo-arb strategy works with Celo node running in "ultra-light" mode, which is much faster to sync. See our Quickstart for instructions on how to start a node in ultra-light mode.

celo-cli CLI tool

To interact with the Celo node, the Hummingbot client depends upon the celo-cli command line tool. Please install celo-cli by following these instructions in the Celo documentation.


This configuration installs the Docker build of Hummingbot on AWS. Note that you can use other cloud providers besides AWS, and you can also install Hummingbot by source or binary in addition to Docker.

1. Set up a cloud instance on AWS

We assume that you already have an AWS account.

Instance type

While the free t2.micro tier may be sufficient to run celo-arb, we recommend a t2.medium instance as the minimum instance type for improved performance.


By default, AWS instances come with 8 GB of storage. We recommend that you increase storage to at least 16 GB to install the Docker version along with the Celo node.

2. Install Docker

# 1) Download Docker install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-docker/install-docker-ubuntu.sh

# 2) Enable script permissions
chmod a+x install-docker-ubuntu.sh

# 3) Run installation

You may need to exit and reconnect to your AWS instance afterwards.

3. Run a Celo ultra-light node

Follow the Celo documentation to pull the Celo Docker image and install/configure a node, but stop right after the step Configure the node and before the step Start the node:

Instead, run the following command to start an ultra-light node rather than a full node:

docker run --name celo-ultralight-node -d --restart unless-stopped -p -v $PWD:/root/.celo $CELO_IMAGE --verbosity 3 --networkid $NETWORK_ID --syncmode lightest --rpc --rpcaddr --rpcapi eth,net,web3,debug,admin,personal --etherbase $CELO_ACCOUNT_ADDRESS --bootnodes $BOOTNODE_ENODES --allow-insecure-unlock

Make sure that you save the address and password of the new Celo account address you created. You will need it later.

4. Install and run Hummingbot

Install the Docker version of Hummingbot:

# 1) Download Hummingbot install, start, and update script
cd ~
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh

# 2) Enable script permissions
chmod a+x *.sh

# 3) Create a hummingbot instance

Afterwards, Hummingbot will start automatically and prompt you to set a password. After you exit, you can use the ./start.sh and ./update.sh commands to run and update Hummingbot, respectively.

5. Connect to the Celo blockchain

Run the command connect celo

Enter the Celo address and password from when you created the Celo account in Step 3.

You should now be connected to Celo. To check, run the balance command and check that the balances of CELo and cUSD match what you hold in your Celo wallet.

Configuration Parameters

The following walks through all the steps when running create command. These parameters are fields in Hummingbot configuration files (located in the /conf folder, e.g. conf/celo_arb_[#].yml).


Enter another exchange you would like to trade on.


Enter your secondary exchange name


Enter the token trading pair for the secondary exchange.


Enter the token trading pair you would like to trade on [secondary_market]


Minimum profitability target required to execute trades.


What is the minimum profitability for you to make a trade?


Order amount for each leg of the arbitrage trade.


What is the amount of [base_asset] per order?


Percent buffer added to the Celo exchange price to account for price movement before trade execution


How much buffer do you want to add to the Celo price to account for slippage (Enter 1 for 1%)?
Edit on GitHub