[Quickstart] Run Your First Trading Bot¶
Now that you have successfully configured a trading bot, you can start market making by running the
You can see your Hummingbot open orders in real-time on the exchange website as you run Hummingbot. Generally, we recommend having the exchange website in a browser alongside the running Hummingbot command line interface.
Step 1: Start bot¶
start to start the market making bot. After some preliminary checks, the bot will fetch the current state of the order book and start placing orders.
You should see messages like the ones below in the log pane:
If you don't see messages related to order creation, check that:
- You have correctly entered API keys
- You have sufficient balance of both tokens in your trading pair
- You have entered
order_amountthat exceeds the minimum order size for your selected exchange
Minimum Order Size
The minimum order size of a trading pair on a specific exchange may vary. You can find more information about this in the Miscellaneous Info section for each Connector.
Step 2: Get the current bot status¶
status to see the current bot status. You can also use the Ctrl-S keyboard shortcut.
This command shows you:
- Preliminary checks: Checks to ensure that the bot is able to run
- Assets: How much of each asset you have
- Active orders: List of the current open orders
- Warnings: Warnings that may impact how your bot runs.
About warning messages
Currently, we default to displaying all warnings, including those related to network and API errors from which Hummingbot may have already gracefully recovered. If the bot appears to be behaving as expected, you may safely ignore certain warnings.
Step 3: List trades and performance¶
history to see what trades the bot has executed and how well it has performed.
This command shows you:
- List of trades: The trades your bot has performed during this session
- Inventory: How your inventory has changed as a result of these trades
- Performance: How much profit or loss your bot has made as a result of these trades
For more information on how Hummingbot calculates performance, refer to Performance Analysis.
Step 4: Exit and restart Hummingbot¶
a) Stop the bot and exit¶
stop to stop the bot, or
exit to stop and also exit Hummingbot.
Hummingbot automatically cancels all outstanding orders and notifies you if it believes that there are potentially uncancelled orders.
b) Restart Hummingbot¶
To restart Hummingbot via Docker, run the
start.sh helper script from the command line. This starts and attaches the Docker container.
Step 5: Import your saved configuration¶
Hummingbot automatically saves your global config file and strategy config file, so you can import these settings without entering them again:
1 2 3 4
hummingbot_files # Top level folder for your instance └── hummingbot_conf # Folder for configuration files (maps to conf/ folder) ├── conf_global.yml # Auto-saved global config file └── conf_pure_market_making_strategy_0.yml # Auto-saved strategy config file
By default, the auto-saved strategy configuration file is named
conf_pure_market_making_strategy_0.yml in your configuration directory.
a) Import configuration¶
config to start the configuration process again, enter your password, then select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Enter your password >>> **** What is your market making strategy >>> pure_market_making Import previous configs or create a new config file? (import/create) >>> import Enter path to your strategy file (e.g. "conf_pure_market_making_strategy_0.yml") >>> conf_pure_market_making_strategy_0.yml # This question appears only if you are trading on a decentralized exchange Would you like to unlock your previously saved wallet? (Yes/No) >>> Config process complete. Enter "start" to start market making.
If trading on a decentralized exchange, this question appears and would ask which wallet you want to unlock if you have multiple wallets stored.
Would you like to unlock your previously saved wallet? (Yes/No) >>> Yes
No to this question will also prompt you to import or create a new wallet.
Congratulations on successfully completing the Hummingbot quickstart guide!
To get the most out of Hummingbot, consult the following resources: