Skip to content

Hummingbot v2.6.1 Release Notes

Released on June 9, 2025

Note

The Hummingbot client release was updated to v2.6.1 on June 12, 2025 to hot-fix critical issues with the market making controllers.

Repository Description GitHub Release DockerHub Release
Hummingbot Core Client v2.6.1 version-2.6.1
Gateway DEX Middleware v2.6.0 version-2.6.0

Note

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

See the full changelogs on GitHub:

How to Update

Docker

Re-run the Deploy setup script: 

git clone https://github.com/hummingbot/deploy.git
cd deploy
bash setup.sh

For individual images, exit running containers, pull the latest images, and restart: 

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

Source

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

git pull origin master # Hummingbot
git pull origin main # Gateway

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 Refactor Updates

This release makes substantial progress toward completing the Gateway simplification initiative approved in HGP-63, whichs to streamline Gateway's architecture and improve its maintainability. The refactor establishes a new standard for DEX connectors that significantly reduces complexity while improving performance and developer experience.

Key Improvements:

  • Improved Code Modularity: Reorganized project structure for better developer experience
  • Enhanced Error Handling: Standardized error handling with descriptive messages
  • Standardized Connector Pattern: Clear pattern for DEX connectors that provide templates for community developers

Updated Connectors:

This release updates the Uniswap and Ethereum connectors to the new simplified standard, serving as reference implementations for future connector development. Additionally, this update completes the refactoring of Solana DEX connectors including Jupiter, Raydium, and Meteora.

Now that the refactor is complete, Hummingbot Foundation will publish bounties to refactor other Gateway connectors and review/merge pull requests to add other Ethereum Virtual Machine (EVM) and Solana Virtual Machine (SVM) based DEXs.

Updated Test Scripts:

The following scripts have been updated to test the refactored connectors:

Pull Request: #444

What's Next in v2.7:

The next release will introduce major improvements to transaction handling and the Hummingbot-Gateway communication interface:

  • Improved Transaction Landing: Complete control over transaction fees with dynamic adjustment based on network conditions, configurable retry strategies, and enhanced visibility into transaction costs
  • Streamlined Hummingbot-Gateway Inteface: Unified interaction through a single GatewayTxHandler, simplified API with generic methods, and more stateless Gateway architecture for better reliability
  • Better User Experience: More reliable DEX trade execution, improved transaction success rates, and easier troubleshooting with enhanced monitoring capabilities

Improved Backtesting Performance

This PR introduces significant performance improvements to the backtesting engine by optimizing timestamp-based lookups. The key changes include:

  • Replaced timestamp-based filtering with pandas datetime index lookups in ExecutorSimulation class, using searchsorted for efficient timestamp lookups (by far the most impactful change)

  • Modified BacktestingEngineBase to use datetime index for all timestamp operations

  • Updated both DCAExecutorSimulator and PositionExecutorSimulator to use datetime-based slicing instead of timestamp filtering

These changes have resulted in a performance improvement of over 40% in backtesting operations by:

  • Eliminating expensive DataFrame filtering operations

  • Leveraging pandas' optimized datetime index operations

  • Reducing memory usage by avoiding creation of intermediate filtered DataFrames

Special thanks to WuonParticle for this contribution! 🙏

Pull Request: #7569

Controller Improvements

Controller Framework & Strategy Enhancements

  • Added global stop-loss, per-strategy leverage support, and automatic position-reduction on opposite signals, giving V2 controllers stronger risk controls.

  • This release introduces a new statistical-arbitrage controller that continuously computes hedge ratios and Z-scores, maintains balanced paired orders, and uses live funding-rate data to fine-tune signals—streaming real-time metrics like hedge ratio, funding, and pair PnL throughout execution.

  • generic.basic_order_example simplified (async update loop, dynamic mid-price, lower default leverage)

  • Candle helpers and sample scripts updated to showcase the new API surface

Market Data Upgrades

  • Introduced MarketDataProvider.get_funding_info(), exposing real-time funding-rate objects to strategies and scripts—unlocking funding-aware logic such as that used by stat_arb.

Binance Connector Reliability Improvements (Perpetual & Spot)

  • Listen-key lifecycle overhauled: periodic 30-minute keep-alive pings, graceful key cleanup at shutdown, and automatic stream re-opening after errors—dramatically reducing “listen key expired” disconnects.

Pull Request: #7554

New XRPL Connector Guide

We've published a comprehensive guide on using the XRP Ledger (XRPL) connector with Hummingbot. The guide covers:

  • Setting up and configuring the XRPL connector
  • Understanding XRPL's unique features like auto-bridging and path-finding
  • Working with both the native XRP token and issued tokens on XRPL
  • Executing trades on XRPL's built-in DEX
  • Best practices for market making on XRPL

Check out the full guide: Using XRP Ledger with Hummingbot

Improved MEXC Connector

This release includes significant improvements to the MEXC connector's reliability and stability:

  • Enhanced Listen Key Management: Improved lifecycle management with retry mechanisms and exponential backoff
  • Better Error Handling: More resilient connection handling with proper error recovery
  • Resource Cleanup: Fixed race conditions and ensured proper cleanup on disconnection
  • Improved Stability: Resolved timing issues with listen key refresh that could cause unexpected disconnections

These improvements make the MEXC connector more reliable for long-running trading sessions and reduce the likelihood of unexpected disconnections.

Pull Request: #7637

Improvements to Other Exchange Connectors

  • #7394 – Added Dexalot candles feed Thanks to yancong001 for this fix! 🙏
  • #7423 – Fixed the issue with Coinbase rate-limits due to mis-use of private limits for public calls Thanks to MementoRC for this fix! 🙏
  • #7506 – Added AMM pool price as well as some improvements to the XRPL connector Thanks to mlguys for this fix! 🙏
  • #7513 – Fixed issue with getting last-traded prices for Coinbase Thanks to WarrenFerrell for this fix! 🙏
  • #7524 – Optimized the Kraken connector to always make a single API call for get_last_traded_prices Thanks to WuonParticle for this fix! 🙏
  • #7576 – Fixed empty snapshot issue for Derive perpetual Thanks to isreallee82 for this fix! 🙏
  • #7599 – Refactored the NDAX connector to the latest standards Thanks to vic-en for this fix! 🙏

Other Updates

hummingbot

  • #7197 – Removed connectors that didn't pass Epoch 11 polls
  • #7522 – Added linting for pre-commit hooks Thanks to WuonParticle for this fix! 🙏
  • #7528 – Updated CoinGecko rate source to support API keys Thanks to WuonParticle for this fix! 🙏
  • #7549 – Added GroupedSetDict, MarketDict, LambdaDict types and integrated add_or_update for cleaner trading-pair updates Thanks to WuonParticle for this fix! 🙏
  • #7622 – Optimized the throttler CPU usage Thanks to cs-mshr for this fix! 🙏
  • #7633 – Fixed the pkg_resources is deprecated as an API error with the client
  • #7634 – Fixed issues with failing tests

gateway

  • #436 – Added AMM position-info route for Raydium
  • #442 – Added source-maps for compiled Typescript Thanks to tigeba for this fix! 🙏