Hummingbot 2.12 Adds Dynamic Order Books and Executor APIs

# Hummingbot v2.12.0 Release Notes


# Hummingbot v2.12.0 Release Notes

*Released on January 26, 2026*

| Repository | Description | GitHub Release | DockerHub Release |
|------------|-------------|----------------|-------------------|
| [Hummingbot Client](https://github.com/hummingbot/hummingbot) | Core Client | [`v2.12.0 changelog`](https://github.com/hummingbot/hummingbot/releases/tag/v2.12.0) | [`version-2.12.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-2.12.0) |
| [Gateway](https://github.com/hummingbot/gateway) | DEX Middleware | [`v2.12.0 changelog`](https://github.com/hummingbot/gateway/releases/tag/v2.12.0) | [`version-2.12.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-2.12.0) |

!!! note
    Other Hummingbot repositories such as [Hummingbot-API](https://github.com/hummingbot/hummingbot-api), [Hummingbot MCP](https://github.com/hummingbot/mcp), [Quants-Lab](https://github.com/hummingbot/quant-lab), and [Condor](https://github.com/hummingbot/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](../installation/index.md) to get started with Hummingbot API with Condor, or the traditional Hummingbot Client.
- **Updating**: See [Updating to New Versions](../installation/update.md) 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 [Condor](../installation/condor.md) installation process has been streamlined:

```bash
git clone https://github.com/hummingbot/condor.git
cd condor
make install
make run
```

See the [Condor Quickstart](../installation/condor.md) for setup instructions and [condor.hummingbot.org](https://condor.hummingbot.org) for full documentation.

#### Hummingbot Client

The [Hummingbot Client](../installation/hummingbot-client.md) installation has been reorganized with cleaner Makefile commands ([#7888](https://github.com/hummingbot/hummingbot/pull/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](../installation/hummingbot-client.md) 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.



Try it out with the [dynamic_orderbook_demo.py](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/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](../exchanges/hyperliquid.md)

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


**hummingbot/gateway**

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


**hummingbot/hummingbot-api**

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