hummingbot /hummingbot
Open source software that helps you create and deploy high-frequency crypto trading bots
★ 21,231⑂ 5,151👁 201⑃ 4,950● 3,508▤ 111
+20
日增长
21,231
stars
5,151
forks
201
watchers
4,950
prs
3,508
issues
111
releases
README
!Hummingbot
----
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
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
Condor (AI harness)
Condor is the AI harness for building and running agentic strategies and bot instances. It connects LLM-powered decision-making to deterministic trade execution via the Hummingbot API, controlled through Telegram or its web dashboard. See condor.hummingbot.org to get started.
hbot CLI
The recommended way to run the Hummingbot client directly 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.
Requires Anaconda or Miniconda.
bash
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
To use hbot outside the conda environment, run make link-cli to add it to your host PATH.
On first use, hbot prompts for a keystore password that encrypts your exchange API keys — set HBOT_PASSWORD or pass --password-stdin to run non-interactively (e.g. in scripts or agent workflows).
Then create a config and run the simple_pmm paper trading script — it simulates trading against live Binance market data, so no API keys are required:
bash
hbot create simple_pmm --name conf_paper_bot.yml \
--set exchange=binance_paper_trade --set trading_pair=BTC-USDT
hbot start conf_paper_bot.yml run it (one bot per install)
hbot status check on it
hbot stop stop gracefully
To trade live, connect your exchange API keys and run a strategy controller like pmm_mister — a reusable V2 strategy whose settings can be tuned live while the Top issues
#7741Feature Request: Add dex exchange lighter16 comments · 2025-08-15#8248 OKX perpetual - crashes after fill when position size is returned as a decimal6 comments · 2026-05-21#7845Derive_perpetual - stuck on Error getting last traded prices when running Multi-Grid controller5 comments · 2025-11-05#7563Derive perpetual - creating order to CLOSE at wrong price when using tight take profit / stop loss spreads5 comments · 2025-04-18#8437Regression: Binance BNB fee conversion with default Gate.io rate oracle causes continuous error storm4 comments · 2026-08-26#8564derive_perpetual cannot place MARKET orders: no order book, and the 5% slippage exceeds the venue's limit band3 comments · 2026-11-14#7823Strategy sends MARKET order when calculated price is NaN #v2_with_controllers #pmm_simple #binance3 comments · 2025-10-26#7330dYdX v4 - Unexpected error running clock tick3 comments · 2024-12-10
Latest release
v2.17.0 v2.17.0 2026-09-22What's Changed Update README exchange tables for v2.16.0 by @fengtality in https://github.com/hummingbot/hummingbot/pull/8402 Update README for master: exchange tables, Getting Started, Strategies by @fengtality in https://github.com/hummingbot/hummingbot/pull/8403 Feat/std executor config failures by @cardosofede in https://github.com/hummingbot/hummingbot/pull/8421 fix / Hyperliquid auth silently accepting wrong private keys (7866) by @ipezygj in https://github.com/hummingbot/hummingbot/pull/8212 Fix Hyperliquid builder fee not resolving when connector is embedded by @fengtality in