Skip to content

[Quickstart] Setup

This guide walks you through how to install Hummingbot and run your first trading bot.

Below, we list what you'll need before you install and run Hummingbot.

System Requirements

Why this is needed: If you are installing Hummingbot either locally or on a cloud server, here are the recommended minimum system requirements:

  • (Linux) Ubuntu 16.04 or later
  • (Mac) macOS 10.12.6 (Sierra) or later
  • (Windows) Windows 10 or later

For more information, view minimum system requirements.

Crypto Inventory

Why this is needed: In order to run trading bot, you'll need some inventory of crypto assets available on the exchange, or in your Ethereum wallet (for Ethereum-based decentralized exchanges).

Remember that you need inventory of both the base asset (the asset that you are buying and selling) and the quote asset (the asset that you exchange for it). For example, if you are making a market in a BTC/USDT trading pair, you'll need some BTC and USDT.

In addition, be aware of the minimum order size requirements on different exchanges. For more information, please see Connectors.

API Keys

Why this is needed: In order to run a bot on a centralized exchange like Binance, you will need to enter the exchange API keys during the Hummingbot configuration process.

For more information on how to get the API keys for each exchange, please see API Keys.

Ethereum Wallet

Why this is needed: In order to earn rewards from Liquidity Bounties, you need an Ethereum wallet. Participants must maintain a balance of at least 0.05 ETH in order to accumulate rewards. This mitigates the risk of spam attacks and ensures that everyone has a fair chances to earn the bounties.

In addition, you'll need to import an Ethereum wallet when you run a trading bot on an Ethereum-based decentralized exchange.

For more information on creating or importing an Ethereum wallet, see Ethereum wallet.

Ethereum Node (DEX only)

Why this is needed: When you run a trading bot on a Ethereum-based decentralized exchange, your wallet sends signed transactions to the blockchain via an Ethereum node.

For more information, see Ethereum node. To get a free node, see Get a Free Ethereum Node.

Next: Install Hummingbot