Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
52 lines (37 sloc) 2.4 KB

The Hummingbot Client

Hummingbot uses a command-line interface (CLI) that helps users configure and run the bot, as well as generate logs of the trades performed.

Starting hummingbot

Installed from Docker

Creating a new instance of hummingbot with docker run will automatically start the hummingbot client (see Docker - Create new instance of hummingbot).

To run a previously created, stopped container:

docker start $NAME && docker attach $NAME

Installed from source

!!! note Make sure that you activate the Anaconda environment with conda activate hummingbot prior to running Hummingbot.

Open a Terminal window and go to the root of the directory that contains Hummingbot. From there, run:

bin/hummingbot.py

User interface

Layout

Hummingbot CLI

The CLI is divided into three panes:

  • Input pane (lower left): where users enter commands
  • Output pane (upper left): prints the output of the user's commands
  • Log pane (right): log messages

Commands

Command Function
help Prints a list of available commands.
start Starts the bot. If any configuration settings are missing, it will automatically prompt you for them.
config Configure the bot. When running for the first time, initializes the bot. If the bot has already been initialized, unlocks the Ethereum wallet.
status Get a status report about price differential between the two exchanges, as well as current orders.
list List wallets, exchanges, configs, and completed trades.

*Example usage: `list [wallets
describe Get detailed information about wallets, exchanges, and orders.

*Example usage: `describe [-w
get_balance Gets the balance of an exchange or wallet.

*Example usage: `get_balance [-c WETH -w
exit | CTRL + C Cancels all orders, saves the log, and exits Hummingbot.
exit -f Force quit without cancelling orders.
stop Cancels all outstanding orders and stops the bot.
export_private_key Print your ethereum wallet private key.
You can’t perform that action at this time.