---

Hummingbot is an open-source framework that helps you design and deploy automated trading strategies, or bots, that can run on many centralized or decentralized exchanges. Over the past year, Hummingbot users have generated over $34 billion in trading volume across 140+ unique trading venues.

The Hummingbot codebase is free and publicly available under the Apache 2.0 open-source license. Our mission is to democratize high-frequency trading by creating a global community of algorithmic traders and developers that share knowledge and contribute to the codebase.

Quick Links

• Website and Docs: Official Hummingbot website and documentation
• Installation: Install Hummingbot on various platforms
• Discord: The main gathering spot for the global Hummingbot community
• YouTube: Videos that teach you how to get the most out of Hummingbot
• Spotify Podcast - The Bot Pod: Weekly livestream and podcast by Hummingbot maintainers
• Twitter: Get the latest announcements about Hummingbot
• Reported Volumes: Reported trading volumes across all Hummingbot instances
• Newsletter: Get our newsletter whenever we ship a new release

Getting Started

The recommended way to run Hummingbot is the hbot command-line interface, installed from source. hbot runs, controls, and monitors a trading bot non-interactively: start/stop a bot, author and tune configs, and read trades, PnL, logs, and status — all scriptable, as compact Markdown with stable exit codes. See the hbot CLI guide for the full reference.

Install and run with hbot (recommended)

Requires Anaconda or Miniconda.

# Clone the repository
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot

# Create the conda environment, build extensions, and expose the `hbot` CLI
make install

# Activate the environment
conda activate hummingbot
hbot --help

Then connect an exchange, create a config, and start a bot:

hbot connect binance                                   # store API keys (encrypted)
hbot create pmm_simple --name conf_my_bot.yml \
     --set connector_name=binance --set trading_pair=BTC-USDT --set total_amount_quote=100
hbot start conf_my_bot.yml                             # run it (one bot per install)
hbot status                                            # check on it
hbot stop                                              # stop gracefully

Full command reference and ontology: hbot CLI guide.

…or with hbot from Docker

Prefer containers? hbot works the same way — install Docker Compose, then:

git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
make setup            # answer `y` to "Include Gateway?" to add the DEX middleware
make deploy           # start the container (interactive client by default)
make link-cli         # put the `hbot` command on your host PATH (dispatches into the container)

hbot --help           # same commands as the source install above

make link-cli installs a small wrapper that runs hbot inside the container, so every command above is identical whether you installed from source or Docker. (Or skip it and use docker exec -it hummingbot hbot <command>.) To dedicate the container to hbot instead of the interactive client, uncomment command: tail -f /dev/null in docker-compose.yml before make deploy — see Running in Docker.

---

Other ways to run Hummingbot

Interactive (terminal UI) client. The classic full-screen client is the Docker default: make deploy, then docker attach hummingbot — or run it from source with make install && make run. With Gateway included it starts in development mode (unencrypted HTTP); for production HTTPS use the DEV=false flag and run gateway generate-certs. See Development vs Production Modes.

Condor (Telegram bot). Follow the instructions in the Condor docs.

---

For comprehensive installation instructions and troubleshooting, visit our Installation documentation.

Getting Help

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

• Consult our FAQ, Troubleshooting Guide, or Glossary
• To report bugs or suggest features, submit a GitHub issue
• Join our Discord community and ask questions in the #support channel

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

Exchange Connectors

Hummingbot connectors standardize REST and WebSocket API interfaces to different types of exchanges, enabling you to build sophisticated trading strategies that can be deployed across many exchanges with minimal changes.

Connector Types

We classify exchange connectors into three main categories:

• CLOB CEX: Centralized exchanges with central limit order books that take custody of your funds. Connect via API keys.

  • Spot: Trading spot markets
  • Perpetual: Trading perpetual futures markets

• CLOB DEX: Decentralized exchanges with on-chain central limit order books. Non-custodial, connect via wallet keys.

  • Spot: Trading spot markets on-chain
  • Perpetual: Trading perpetual futures on-chain

• AMM DEX: Decentralized exchanges using Automated Market Maker protocols. Non-custodial, connect via Gateway middleware.

  • Router: DEX aggregators that find optimal swap routes
  • AMM: Traditional constant product (x*y=k) pools
  • CLMM: Concentrated Liquidity Market Maker pools with custom price ranges

Exchange Sponsors

We are grateful for the following exchanges that support the development and maintenance of Hummingbot via broker partnerships and sponsorships.

Exchange	Type	Sub-Type(s)	Connector ID(s)	Discount
Binance	CLOB CEX	Spot, Perpetual	binance, binance_perpetual
BitMart	CLOB CEX	Spot, Perpetual	bitmart, bitmart_perpetual
Bitget	CLOB CEX	Spot, Perpetual	bitget, bitget_perpetual
Derive	CLOB DEX	Spot, Perpetual	derive, derive_perpetual
dYdX	CLOB DEX	Perpetual	dydx_v4_perpetual	-
Gate.io	CLOB CEX	Spot, Perpetual	gate_io, gate_io_perpetual
HTX (Huobi)	CLOB CEX	Spot	htx
Hyperliquid	CLOB DEX	Spot, Perpetual	hyperliquid, hyperliquid_perpetual	-
KuCoin	CLOB CEX	Spot, Perpetual	kucoin, kucoin_perpetual
OKX	CLOB CEX	Spot, Perpetual	okx, okx_perpetual
XRP Ledger	CLOB DEX	Spot	xrpl	-

Other Exchange Connectors

Currently, the master branch of Hummingbot also includes the following exchange connectors, which are maintained and updated through the Hummingbot Foundation governance process. See Governance for more information.

Exchange	Type	Sub-Type(s)	Connector ID(s)	Discount
0x Protocol	AMM DEX	Router	0x	-
Aevo	CLOB CEX	Perpetual	aevo_perpetual	-
Architect	CLOB CEX	Perpetual	architect_perpetual	-
Backpack	CLOB CEX	Spot, Perpetual	backpack, backpack_perpetual	-
Balancer	AMM DEX	AMM	balancer	-
BingX	CLOB CEX	Spot	bing_x	-
Bitrue	CLOB CEX	Spot	bitrue	-
Bitstamp	CLOB CEX	Spot	bitstamp	-
BTC Markets	CLOB CEX	Spot	btc_markets	-
Bybit	CLOB CEX	Spot, Perpetual	bybit, bybit_perpetual	-
Coinbase	CLOB CEX	Spot	coinbase_advanced_trade	-
Curve	AMM DEX	AMM	curve	-
Decibel	CLOB CEX	Perpetual	decibel_perpetual	-
Dexalot	CLOB DEX	Spot	dexalot	-
EVEDEX	CLOB CEX	Perpetual	evedex_perpetual	-
Foxbit	CLOB CEX	Spot	foxbit	-
GRVT	CLOB CEX	Perpetual	grvt_perpetual	-
Injective Helix	CLOB DEX	Spot, Perpetual	injective_v2, injective_v2_perpetual	-
Jupiter	AMM DEX	Router	jupiter	-
Kraken	CLOB CEX	Spot	kraken	-
Meteora	AMM DEX	CLMM	meteora	-
MEXC	CLOB CEX	Spot	mexc	-
NDAX	CLOB CEX	Spot	ndax	-
Pacifica	CLOB CEX	Perpetual	pacifica_perpetual	-
PancakeSwap	AMM DEX	AMM	pancakeswap	-
QuickSwap	AMM DEX	AMM	quickswap	-
Raydium	AMM DEX	AMM, CLMM	raydium	-
SushiSwap	AMM DEX	AMM	sushiswap	-
Trader Joe	AMM DEX	AMM	traderjoe	-
Uniswap	AMM DEX	Router, AMM, CLMM	uniswap	-

Other Hummingbot Repos

• Condor: Telegram Interface for Hummingbot
• Hummingbot API: The central hub for running Hummingbot trading bots
• Hummingbot MCP: Enables AI assistants like Claude and Gemini to interact with Hummingbot for automated cryptocurrency trading across multiple exchanges.
• Quants Lab: Jupyter notebooks that enable you to fetch data and perform research using Hummingbot
• Gateway: Typescript based API client for DEX connectors
• Hummingbot Site: Official documentation for Hummingbot - we welcome contributions here too!

Contributions

The Hummingbot architecture features modular components that can be maintained and extended by individual community members.

We welcome contributions from the community! Please review these guidelines before submitting a pull request.

To have your exchange connector or other pull request merged into the codebase, please submit a New Connector Proposal or Pull Request Proposal, following these guidelines. Note that you will need some amount of HBOT tokens in your Ethereum wallet to submit a proposal.

Legal

• License: Hummingbot is open source and licensed under Apache 2.0.
• Data collection: See Reporting for information on anonymous data collection and reporting in Hummingbot.