Skip to content

Hummingbot v2.12.0 Release Notes

Released on January 26, 2026

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

Note

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

How to Install / Update

  • 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

🚀 Simplified Installation & Deployment

This release brings major improvements to the installation experience across multiple repositories, making it easier than ever to get started with Hummingbot.

Hummingbot API + Condor

The Hummingbot API and Condor installation process has been streamlined with a one-line install command:

curl -fsSL https://raw.githubusercontent.com/hummingbot/deploy/main/setup.sh | bash -s

This single command clones both repositories, prompts for credentials, and starts all services automatically. See the Hummingbot API Quickstart for full installation walkthrough.

Hummingbot Client

The Hummingbot Client installation has been reorganized with cleaner Makefile commands (#7888):

  • Improved Conda Integration: make install now correctly creates and updates the conda environment.
  • Backward Compatible: Previous ./start command arguments still work with make run, e.g., make run -p -f strategy.yml -c config.yml

See the Hummingbot Client Quickstart for full instructions.

📊 Dynamic Order Book Initialization

Hummingbot now supports dynamic order book initialization, a performance optimization that allows order books to be loaded on-demand rather than all at startup. This feature is particularly beneficial for traders running strategies across multiple exchanges or managing large numbers of trading pairs.

Previously, Hummingbot would initialize order books for all configured trading pairs when the bot started, which could lead to longer startup times and higher memory usage. With this update, order books are now initialized dynamically when they're actually needed.

Highlights

  • On-Demand Loading: Order books are initialized only when a trading pair is actively used, reducing startup time significantly.

  • Lower Memory Footprint: Memory is allocated only for trading pairs currently in use, enabling more efficient resource utilization.

  • Runtime Flexibility: Strategies can dynamically add or remove trading pairs without requiring a bot restart.

Try it out with the dynamic_orderbook_demo.py script.

📈 Hyperliquid HIP-3 Markets Support

Hummingbot now fully supports HIP-3 (DEX) markets on the Hyperliquid Perpetual connector, enabling traders to access a broader range of trading pairs including permissionlessly listed tokens on Hyperliquid's decentralized spot exchange.

Highlights

  • Full HIP-3 Integration: Trade on permissionless DEX markets with support for the unique HIP-3 trading pair format, including both uppercase and lowercase prefixes.

  • Candles & Order Book Support: Complete data feed integration including candlestick data and real-time order book updates for HIP-3 markets.

  • Rate Source Integration: Added hyperliquid_perpetual as a rate source mode for accurate mid-price calculations.

📚 Documentation: Hyperliquid Connector Guide

Special thanks to isreallee82 for these contributions (#7875, #7952)! 🙏

🛠️ Hummingbot API Enhancements

New Services Architecture

  • UnifiedConnectorService: Single source of truth for all connector instances, managing both trading connectors (authenticated, per-account) and data connectors (shared, for public market data)
  • MarketDataService: Centralized market data access (candles, order books, prices) with automatic feed lifecycle management
  • TradingService: Centralized trading operations with AccountTradingInterface - a ScriptStrategyBase-compatible interface that executors can use
  • ExecutorService: Manages Hummingbot executors directly via API without Docker containers or full strategy setup

New API Endpoints

Endpoint Description
/executors Full CRUD for executor management (Position, Grid, DCA, TWAP, Arbitrage, XEMM, Order executors)
/rate-oracle Rate oracle configuration and rate queries

New Features

  • Position Hold Tracking: Aggregates positions from executors stopped with keep_position=true, tracking buy/sell amounts, breakeven prices, and realized/unrealized PnL
  • Order Book Tracker Registration: Proper management of order book trackers per trading pair with automatic cleanup
  • Executor Persistence: Database storage of executor state and history

🔑 Gateway Wallet Management API

Gateway now includes comprehensive wallet management capabilities, enabling programmatic wallet creation, private key retrieval, and token transfers directly through the API. This feature supports both Solana and Ethereum chains with a security-first design.

New API Endpoints

Endpoint Description
POST /wallet/create Create a new wallet server-side, stored encrypted in Gateway
POST /wallet/show-private-key Retrieve the private key for a wallet (requires passphrase)
POST /wallet/send Send native tokens (SOL/ETH) or SPL/ERC20 tokens

Programmatic Wallet Creation: Generate new wallets via API without manual key management, perfect for automated trading infrastructure.

Secure Key Storage: All wallets are encrypted using Gateway's passphrase before storage.

Local Generation Option: Includes a CLI script (pnpm wallet:create) for generating keypairs locally before adding to Gateway.

Other Updates

hummingbot/hummingbot

  • #7875 – Added HIP-3 (DEX) markets support for Hyperliquid Perpetual connector Thanks to isreallee82 for this contribution! 🙏
  • #7884 – Updated controllers to include performance report data, enabling access to realized PnL for compound interest calculations. Thanks to lgrawet for this contribution! 🙏
  • #7930 – Added dynamic order book initialization support for Binance Spot, Binance Perpetual, and Gate.io connectors (see Release Highlights above).
  • #7888 – Refactor Makefile for improved structure and commands
  • #7892 – Added MQTT reporting functionality for controllers.
  • #7897 – Fixed ModuleNotFoundError for commlib.transports that prevented Hummingbot from starting.
  • #7909 – Added support for using python build for building the Hummingbot library
  • #7922 – Added 2h interval support for bitget_perpetual connector Thanks to lgrawet for this fix! 🙏
  • #7926 – Fixed incorrect PnL reporting in bitget_perpetual connector by correcting negative fee calculation to match the spot connector implementation Thanks to lgrawet for this fix! 🙏
  • #7949 – Fixed Gateway swap execution flow and improved XEMM order tracking
  • #7952 – Enabled HIP-3 markets by default and removed enable_hip3_markets configuration option Thanks to isreallee82 for this fix! 🙏

hummingbot/gateway

  • #576 – Fixed error handling to return 404 instead of 500 for closed or non-existent CLMM positions.
  • #577 – Added wallet generation script and wallet API endpoints (see Wallet Management section above).
  • #582 – Removed token cache for immediate token availability. Tokens added via POST /tokens/ now work immediately without requiring a Gateway restart.
  • #587 – Added split routing support in Uniswap and PancakeSwap quote-swap operations.

hummingbot/hummingbot-api

  • #104 – Added support for custom controller data and wallet creation functionality.
  • #106 – Improved order polling with automatic synchronization, enhanced connector configuration metadata, and added Rate Oracle API endpoints for price feed management.
  • #110 – Major architectural refactoring with new services (UnifiedConnectorService, MarketDataService, TradingService, ExecutorService) and native executor support via API (see Release Highlights above).