Skip to content

Hummingbot v2.11.0 Release Notes

Released on December 15, 2025

Repository Description GitHub Release DockerHub Release
Hummingbot Client Core Client v2.11.0 changelog version-2.11.0
Gateway DEX Middleware v2.11.0 changelog version-2.11.0

Note

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

How to Install / Update

Configuration Changes in v2.11.0

This release includes schema changes to both Hummingbot and Gateway configuration files. Existing configuration files are not compatible and must be removed before updating. See Updating to New Versions - Updates with Configuration Changes for detailed instructions.

  • New Installation: See the newly revamped Installation to get started with Hummingbot API with Condor, or the traditional Hummingbot Client.
  • Updating: See Updating to New Versions for update instructions.

Release Highlights

🤖 Condor — Telegram Bot for Managing Hummingbot Instances

Condor is a new Telegram-based control center for Hummingbot, giving traders a fast and intuitive way to monitor bots, run trades, manage liquidity, and interact with Gateway — all directly from their phone.

Built on the Hummingbot API, Condor provides a streamlined interface for both CEX and DEX operations, offering real-time dashboards, interactive menus, and a unified configuration system. Whether you're swapping tokens, managing CLMM liquidity, or monitoring your grid strategies, Condor brings full Hummingbot control into a lightweight, mobile-friendly UI.

Key Features

  • Portfolio Dashboard: View PnL, asset distribution, positions, LP states, and historical charts
  • Bot Management: Monitor multiple bots, controllers, metrics, logs, and status in real time
  • CEX & DEX Trading: Place spot/perp orders and execute DEX swaps with quotes and slippage control
  • Liquidity Management: Browse pools, manage CLMM positions, collect fees, and close positions
  • Server & API Key Configuration: Add/edit/delete Hummingbot API servers and exchange credentials
  • AI Assistant (Coming Soon): Natural-language trading through GPT-4o + MCP tooling

Condor makes Hummingbot more accessible than ever — perfect for traders running bots across multiple environments who want lightweight, remote monitoring and execution without needing a desktop terminal. The Hummingbot API Quickstart includes step-by-step Condor setup instructions. See Condor for more information.

🔗 GitHub: https://github.com/hummingbot/condor

🐳 New Orca Connector for Solana DEX Trading

We’re excited to introduce a brand-new Orca connector, bringing one of Solana’s most popular DEXs into the Hummingbot ecosystem. This integration enables traders to execute swaps and liquidity-sensitive strategies on Solana using Hummingbot’s unified API.

This connector was developed through our connector bounties program, which empowers community developers and ecosystem partners to build high-quality integrations in an open and transparent process.

Highlights

  • Seamless Orca Integration: Full support for interacting with Orca’s Whirlpool AMM and swap functionality.
  • Solana Native Support: Utilizes Solana-specific transaction building, signing, and routing logic for fast, reliable execution.
  • DEX-Focused Architecture: Designed to work across Orca pools, enabling market-making, arbitrage, and custom strategy development.
  • Gateway Compatibility: Fully accessible through Gateway, making it easy to use via the Hummingbot UI or external workflows.

This new connector expands Hummingbot’s cross-chain DEX capabilities and strengthens our support for high-performance Solana-based trading.

📚 Documentation: Orca Connector Guide

Special thanks to mlguys for this contribution! 🙏

🛠️ Gateway Connector & Infrastructure Enhancements

This release delivers a wide set of improvements across Gateway’s Solana and EVM connectors, focusing on token reliability, pool discovery, error-handling consistency, and CLMM stability. Together, these updates strengthen cross-chain LP workflows, improve swap accuracy, and make Gateway more resilient to real-world RPC/provider quirks.

Highlights

  • Dynamic & Robust Token Handling #543 Gateway now supports unlisted ERC-20 tokens, dynamic wrapped-token detection, and graceful fallbacks when external RPCs (like Helius) return mixed parsed/base64 formats. This resolves issues in Polygon wrapping, BigInt conversions, and post-transaction balance extraction.

  • CLMM Stability Improvements (Meteora, Raydium, Orca, PancakeSwap-Sol) #550 Added fixes for InvalidPositionWidth errors, accurate Meteora fee reporting, improved user-facing swap/allowance errors, and reliable handling of unknown pool tokens. CLMM operations across Solana ecosystems now behave consistently and predictably.

  • WebSocket Monitoring & Real-Time Discovery Tools #555 Introduced Helius and Infura WebSocket listeners for live transaction monitoring, plus CoinGecko-based token & pool discovery with automatic caching. This enhances ecosystem coverage and allows instant visibility into new tokens and pool opportunities.

  • Standardized Error Handling Framework #563 #564 A new centralized HttpError service standardizes error messages and HTTP responses across ~70 connector routes, improving clarity and debugging consistency for all Solana and EVM connectors.

  • Expanded DEX & Provider Compatibility #569 Added GeckoTerminal DEX mappings for Uniswap V3 on major EVM networks, upgraded Meteora SDK, improved PancakeSwap-Sol parser resilience, migrated Jupiter to its new API, and unified all external service keys (Helius, Infura, CoinGecko, Etherscan) under a shared config model.

🔐 Hyperliquid API Key Authentication Now Supported

Hummingbot now supports API key–based authentication for both the Hyperliquid Spot and Hyperliquid Perpetual connectors, offering a more flexible alternative to the existing Arbitrum wallet + private key setup.

With this enhancement, traders can generate API key/secret credentials directly from the Hyperliquid web interface and use them to place orders, manage positions, and run automated strategies through Hummingbot.

Highlights

  • Dual Authentication Modes: Choose between API key authentication or Arbitrum wallet signing, depending on your workflow and security preferences.
  • Spot + Perpetual Coverage: Unified API key support across both hyperliquid (spot) and hyperliquid_perpetual (perp) connectors.
  • Simplified Setup: Configure your API credentials directly in Hummingbot without needing an on-chain private key.

This update streamlines the onboarding experience for Hyperliquid users and enhances compatibility with a broader range of trading setups.

📚 Documentation: Hyperliquid Connector Guide

Special thanks to gtwototoo for this contribution! 🙏

Other Updates

hummingbot/hummingbot

  • #7829 - Added XEMM strategy improvements
  • #7837 - Added API-keys support for Hyperliquid Spot/Perpetual
  • #7849 - Removed Binance-US connector
  • #7851 - Upgraded Injective sdk to latest v1.12 version
  • #7854 - Fixed Gateway docker connection issue
  • #7858 - Updated Derive connector to latest version
  • #7872 - Updated Gateway config updates to allow decimal values
  • #7877 - Changed Gateway query price to SELL side to avoid errors of quote not found for exact amount error

hummingbot/gateway

  • #540 - Improved slippage handling, added CLMM price limits, standardized tx execution, and began unifying pool/pair derivation for EVM/Uniswap-like connectors. Thanks to vic-en for this contribution! 🙏
  • #552 - Fixed Polygon approval gas error issue reported in #545 Thanks to gglucass for this fix! 🙏
  • #565 - Added missing Solana instance for wrapping WSOL on Orca routes