Hummingbot v2.10.0 Release Notes¶

Released on November 03, 2025

Repository	Description	GitHub Release	DockerHub Release
Hummingbot	Core Client	`v2.10.0`	`version-2.10.0`
Gateway	DEX Middleware	`v2.10.0`	`version-2.10.0`

See the full changelogs on GitHub:

Note

Other Hummingbot repositories such as Dashboard, Hummingbot-API, Hummingbot API Client, Quants-Lab, Deploy and Hummingbot MCP follow a continuous deployment model without fixed version releases. Use the main branch for these repositories.

How to Install and Update¶

Docker - Hummingbot API with MCP + Dashboard¶

The official and recommended way to run Hummingbot is through the Hummingbot API, which provides:

🤖 MCP (AI Assistant Integration) - Control your trading with Claude, ChatGPT, or Gemini
📊 Dashboard - Visual interface for bot management
🔧 Full REST API - Complete programmatic control

To install or update, run the Hummingbot API setup script:

git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh

This single command sets up:

Hummingbot API (port 8000)
PostgreSQL database
EMQX message broker
Dashboard (optional: port 8501)

After setup, connect an AI assistant:

See the MCP Installation Guide for instructions on connecting:

Claude Code (recommended) - One-line CLI setup
Gemini CLI - Google's AI terminal agent
Codex CLI - OpenAI's coding assistant
Claude Desktop - GUI application
Docker MCP Catalog - Visual setup via Docker Desktop

Using AI to control Hummingbot API

Deploy Repo is now deprecated

The Deploy repository is being deprecated in favor of the Hummingbot API installation above. Existing users should migrate to the Hummingbot API for continued support and new features.

Docker - Hummingbot Client Only¶

For running individual Hummingbot client containers without the API infrastructure:

Hummingbot:

docker compose down
docker pull hummingbot/hummingbot:latest
docker compose up -d

Source¶

Update the branches of each repo to this release by running:

# Hummingbot
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
git pull origin master

# Gateway
git clone https://github.com/hummingbot/hummingbot.git
cd gateway
git pull origin main

Afterwards, follow the instructions to re-install dependencies and compile the codebase for each repository. See Install Hummingbot from Source and Install Gateway from Source.

Release Highlights¶

🔗 Gateway × Hummingbot API Integration¶

In #89, we integrated Gateway directly with the Hummingbot API, creating a unified control plane for both centralized and decentralized exchange operations.

Key Features

Lifecycle Management: Start and stop Gateway instances via API and MCP
Blockchain Queries: Retrieve on-chain balances and wallet data through standardized endpoints
DEX Swaps: Execute swaps on supported decentralized exchanges through the API
Unified Interface: Control both CEX and DEX trading layers through a single REST and MCP interface

This integration bridges the Python-based Hummingbot API and TypeScript-based Gateway middleware, providing a seamless workflow for AI-assisted trading automation and portfolio management across all supported blockchains and exchanges.

✨ Enhanced MCP Capabilities¶

We've significantly upgraded the Hummingbot MCP server to support multi-server management and Gateway integration, making AI-driven orchestration more powerful and flexible.

Multi-Server Support

Simplified Setup: Removed the mandatory HUMMINGBOT_API_URL requirement — start the MCP server without predefining a single API instance
Multi-Server Management: Add, switch, and manage multiple Hummingbot API instances (local or remote) from a single interface
Persistent Storage: Server configurations and credentials are now stored in a dedicated volume for long-term persistence across sessions

Gateway Integration via MCP

Unified Control: Manage both Hummingbot API and Gateway instances through the same MCP interface
Cross-Chain Operations: Execute CEX and DEX operations seamlessly through natural language commands
AI-Driven Workflow: Enable Claude and other AI assistants to orchestrate complex multi-chain trading strategies

This enhancement enables traders to manage multiple Hummingbot deployments from a single AI interface, coordinate strategies across CEX and DEX venues, and monitor multiple bot instances without reconfiguring the MCP client. The flexible architecture supports both local testing and remote production servers, streamlining workflows for traders running complex, multi-instance operations.

📚 Documentation: Hummingbot MCP

🔄 Bitget Connector Updates (Spot + Perpetual)¶

We've introduced a new Bitget Spot connector and refactored the Perpetual connector to align with Bitget's latest API specifications, strengthening our partnership with Bitget.

This connector was developed through our connector bounties program, which enables exchanges to integrate with Hummingbot through a transparent, community-driven process. The bounty was funded by Bitget and executed by talented developers from our community.

Highlights

New Spot Connector: Full integration for Bitget Spot trading.
Perpetual Refactor: Migrated to the newest API endpoints for improved reliability.
Candles Feed Support: Added candle feeds for both Spot and Perpetual markets (#7794).
Broker Code Integration: Enabled broker code functionality (#7822).

These updates provide better performance, stability, and feature parity with Bitget’s production systems.

Special thanks to gtwototoo for this contribution! 🙏

📚 Documentation: Bitget Connector Guide

🥞 PancakeSwap Solana CLMM Connector¶

We've added complete support for PancakeSwap on Solana, bringing concentrated liquidity market making to Solana's fastest-growing DEX.

Key Features

Full CLMM Support: Open/close positions, add/remove liquidity, and collect fees on PancakeSwap V3 pools
WSOL Wrapping: Automatic SOL ↔ WSOL conversion for seamless trading
Token-2022 Compatible: Full support for Solana's new token standard and NFT position tracking
Native Solana Integration: Built on Solana's high-performance blockchain infrastructure

PancakeSwap Solana leverages the same concentrated liquidity mechanics as PancakeSwap V3 on EVM chains, now optimized for Solana's speed and low transaction costs. This integration enables sophisticated market making strategies on Solana's most liquid trading pairs.

🔗 Trade on PancakeSwap Solana

📚 Documentation: PancakeSwap Gateway Connector

🛠️ Gateway Infrastructure Improvements¶

We’ve rolled out extensive Gateway upgrades spanning RPC handling, pool storage, and connector support across multiple networks.

Highlights

RPC Provider System: Introduced flexible provider abstraction with integrations for Helius (Solana) and Infura (EVM networks), offering regional endpoints, Jito support, and dynamic command updates via gateway config <provider> update.
Enhanced Pool Storage: Migrated pool data structures to include canonical on-chain token addresses and fees, improving validation and data accuracy across 50 + pools (Raydium, Meteora, Uniswap, PancakeSwap).
EIP-1559 Gas Controls: Introduced configuration for maxFeePerGas, maxPriorityFeePerGas, and baseFeeMultiplier, enabling both fixed and dynamic gas pricing strategies with Etherscan integration.
Client Integration: Updated Hummingbot commands and schemas to align with the new pool structure (baseTokenAddress, quoteTokenAddress, feePct).

Collectively, these changes make Gateway more robust, modular, and transparent — paving the way for cross-chain liquidity management and advanced AMM strategies.

Other Updates¶

hummingbot/hummingbot

#7793 - Fixed Unexpected error while processing event 198 on Hyperliquid.
#7796 - Implemented TA-Lib as the new technical-analysis library (replacing pandas-ta) Thanks to lgrawet for this fix! 🙏
#7797 - Added ping payload to keep Hyperliquid candle feeds active Thanks to mlguys for this fix! 🙏
#7813 - Added EUROP pairs to the XRPL connector Thanks to mlguys for this fix! 🙏
#7828 - Added a safety check for setting leverage on perpetual markets

hummingbot/hummingbot-api

#86 - Updated pandas-ta dependency alignment with Hummingbot core. Thanks to lgrawet for this fix! 🙏

hummingbot/dashboard

#266 - UUpdated compatibility with pandas-ta ≥ 0.4 for consistency Thanks to lgrawet for this fix! 🙏