Skip to content

Documentation

Hummingbot is an community-driven, open source Python framework for building automated market making and algorithmic trading bots, maintained by Hummingbot Foundation.

It is designed to be modular and extensible, allowing users to automate any trading strategy on any exchange and blockchain.

Getting Started

We recommend installing Hummingbot using Docker if you want the simplest, easiest installation method and don't need to modify the Hummingbot codebase. Check out Install via Docker for the basic process.

For Developers

If you're a developer looking to build custom strategies or exchange connectors, consider installing Hummingbot from source. There are instructions for macOS, Linux and Windows - see Source Installation.

Afterwards, check out the Academy category in the Hummingbot Blog for blog posts and step-by-step tutorials on how to use Hummingbot.

Strategies

A Hummingbot strategy automates an algorithmic trading strategy based on a configuration file, allowing the template containing the strategy logic to be defined publicly, while users can keep their configurations private.

As of the 2.0 release, the framework offers two ways to create Hummingbot strategies:

  • Scripts: Scripts are the entry point for all Hummingbot strategies. A script's on_tick method defines the actions taken each clock tick, and it provides access to core Hummingbot components like connectors. They can range in complexity from a simple Python file that contains all strategy logic to a launcher script launches multiple Controllers, each defining a separate sub-strategy.

  • Controllers: Controllers define a modularized strategy using components such as Executors, enabling backtesting and faciliates multi-bot deployment using Dashboard.

In the past, there were legacy strategy templates (V1 Strategies), the original Hummingbot strategies that are more rigid and less customizable than those built using the new Strategy V2 framework.

Connectors

Hummingbot connectors standardize trading logic and order types across different types of exchanges and blockchain networks, so that strategies can access standardized methods that work across all connectors of that type.

Each connector's code is contained in modularized folders in the Hummingbot and/or Gateway codebases:

  • CLOB Connectors: Connectors to central limit order book (CLOB) centralized and decentralized exchanges
  • AMM Connectors: Connectors to automated market maker (AMM) decentralized exchanges

Official Code Repositories

All Hummingbot Foundation code is maintained and stored in repositories in the official Github and DockerHub organization accounts. These are the only code repositories used to release official versions of Hummingbot. Please download Hummingbot and Hummingbot-related software from only these official sources.

The Hummingbot framework is comprised of multiple code repositories, hosted on the Hummingbot Foundation Github, that are maintained by the Foundation alongside individual community members. All code is open sourced under the Apache 2.0 or MIT licenses.

Hummingbot started as a command line interface (CLI) tool, and the Hummingbot Client is still the basic way to interact with the framework.

Today, the framework comprises companion modules to assist with other aspects of crypto algorithmic trading:

  • Gateway: Middleware to interact with AMM connectors and other DeFi protocols on various blockchains
  • Dashboard: A web-based user interface for deploying multi-bot trading strategies
  • Backend API: Backend API that exposes bot management endpoints for Dashboard and others to interact with
  • Quants-Lab: A sandbox for users to test their trading ideas and strategies

Getting Help

If you encounter issues or have questions, here’s how you can get assistance:

We pledge that we will not use the information/data your provide us for trading purposes nor share them with third parties.

Learn Market Making in Botcamp

To gain a deeper understanding of Hummingbot strategies along with access to the latest Hummingbot framework updates, check out Botcamp, the official training and certification program for Hummingbot.

Operated by the people behind Hummingbot Foundation, Botcamp offers bootcamps and courses that teach you how to design and deploy advanced algo trading and market making strategies using Hummingbot's Strategy V2 framework.