Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hummingbot/hummingbot/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
What is Hummingbot?

The Hummingbot codebase is free and publicly available under the Apache 2.0 open-source license. The 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. Hummingbot enables you to:
  • Build sophisticated trading strategies using Python
  • Deploy bots across multiple exchanges simultaneously
  • Run strategies on both centralized (CEX) and decentralized (DEX) exchanges
  • Backtest strategies using historical data
  • Leverage modular components like controllers and executors for advanced strategy design

​
Key Features

Multi-Exchange Support

Connect to 140+ exchanges including Binance, Coinbase, dYdX, Hyperliquid, and DEXs via Gateway middleware

Strategy Framework V2

Advanced architecture with Controllers, Executors, and orchestration for building complex trading systems

Market Making & Arbitrage

Pre-built strategies for pure market making, cross-exchange arbitrage, liquidity mining, and more

Gateway DEX Middleware

Standardized connectors for AMM/CLMM DEXs across Ethereum, Solana, Avalanche, and other chains

Script Strategies

Write custom strategies in Python with full control over trading logic and parameters

Backtesting & Analytics

Test strategies with historical data and analyze performance with Quants Lab notebooks

​
Exchange Connector Types

Hummingbot supports three main categories of exchange connectors:
Centralized exchanges with central limit order books that take custody of your funds. Connect via API keys.Spot Markets: Binance, Coinbase, OKX, KuCoin, Gate.io, Kraken, and morePerpetual Markets: Binance Perpetual, Bybit Perpetual, OKX Perpetual, and more
Many exchanges offer fee discounts through Hummingbot’s referral partnerships - see the README for details
Decentralized exchanges with on-chain central limit order books. Non-custodial, connect via wallet keys.Examples: dYdX, Hyperliquid, Injective Helix, Vertex, Dexalot, XRPL DEXThese exchanges combine the benefits of DEX custody with the familiar order book trading model.
Decentralized exchanges using AMM protocols. Non-custodial, connect via Gateway middleware.Router: DEX aggregators (Uniswap Router, 0x Protocol, Jupiter)AMM: Constant product pools (Uniswap V2, SushiSwap, PancakeSwap)CLMM: Concentrated liquidity (Uniswap V3, Raydium CLMM, Meteora)

​
Architecture Overview

Hummingbot’s modular architecture separates concerns into distinct layers: 
hummingbot/
├── client/              # CLI interface and user interaction
├── connector/           # Exchange connectors (spot, perpetual, gateway)
├── core/                # Core infrastructure (events, data types, utils)
├── strategy/            # Built-in strategies (PMM, arbitrage, etc.)
├── strategy_v2/         # V2 framework (controllers, executors)
└── smart_components/    # Reusable trading components
The V2 architecture introduces Controllers (high-level strategy logic) and Executors (order execution primitives) that can be composed to build sophisticated strategies. Learn more in the Architecture guide.

​
Get Started

Installation

Install Hummingbot using Docker or from source

Quickstart

Run your first trading bot in minutes

Architecture

Understand the framework’s modular design

Strategies

Explore built-in and example strategies

​
Community & Support

Discord

Join 30,000+ traders and developers

YouTube

Video tutorials and strategy guides

GitHub

Contribute to the open-source codebase
  • Condor: Telegram interface for Hummingbot
  • Gateway: TypeScript middleware for DEX connectors
  • Quants Lab: Jupyter notebooks for research and backtesting
  • Hummingbot MCP: AI assistant integration for Claude and Gemini
Hummingbot pledges to never use user data for trading purposes or share it with third parties. See the data reporting policy for details.