Skip to content

Hummingbot v2.15.0 Release Notes

Released on June 17, 2026

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

Note

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

How to Install / Update

Release Highlights

🔌 Connector Updates

⚡ Lighter

Spot and perpetual connectors for Lighter, a decentralized exchange built on a zero-knowledge rollup with CLOB order books and verifiable on-chain execution. Place, update, and manage spot and perpetual orders, positions, and funding through the standard Hummingbot connector model, including candles data feeds for both markets.

See Lighter for documentation on how to use this connector.

Bounty: #8159 | PR: #8223 | Thanks to vic-en! 🙏

Hyperliquid

Several improvements to the spot and perpetual connectors:

  • #8265 – Added Foundation builder code support for mainnet order attribution on spot and perpetual markets
  • #8271 – Fixed spot candles to use trading pair instead of symbol
  • #8252 – Added websocket message timeout to improve connection stability
  • #8216 – Fixed perpetual stale positions after partial close

Perpetual Connector Updates

Improvements to perpetual position management across backtesting and live trading:

  • #8284 – Improved ONEWAY connectors and position hold handling in backtesting
  • #8274 – Improved position hold management
  • #8249 – Improved position mode setting flow
  • #8240 – Fixed initial positions initialization failure

Other Connector Updates

  • Gate.io: Changed the default rate oracle source from Binance to Gate to avoid geo-restriction failures (#8294); fixed perpetual duplicate order creation (#8279)
  • KuCoin: Updated perpetuals connector for current API compatibility (#8273). Thanks to dizpers! 🙏
  • Decibel: Updated perpetual connector to fetch trading fees from user_fee_rates API (#8241). Thanks to WGB5445! 🙏
  • Binance: Updated perpetual WebSocket subscriptions for candles and liquidations (#8209).
  • BingX: Added LIMIT_MAKER support to spot connector (#8174). Thanks to claygeo! 🙏
  • Injective: Updated injective-py dependency to version 1.14 (#8210). Thanks to aarmoa! 🙏

🔒 Tailscale Security

Condor and Hummingbot API now support Tailscale for private, encrypted access between your devices. Connect over a tailnet instead of exposing port 8000 to the public internet—keeping order placement, balances, and bot control behind a VPN only your machines can reach.

See the Tailscale guide for setup instructions, or read Securing Condor and Hummingbot API with Tailscale for a full security walkthrough.

PR: condor #92 | hummingbot-api #156

🔗 Chainstack RPC Provider

Gateway adds Chainstack as a cross-chain RPC provider for both Solana and EVM networks—the first provider to use API-driven node discovery instead of URL templating. Route DEX traffic through deployed Chainstack nodes for lower latency, higher availability, and more reliable swap execution.

See RPC Providers for setup instructions.

PR: #623 | Thanks to smypmsa! 🙏

🌊 Gateway CLMM Fixes & Enhancements

Important fixes and enhancements to Gateway's concentrated liquidity (CLMM) connectors for Uniswap, Orca, and Meteora:

  • Inverted BUY price fix: CLMM quote-swap on Orca and Meteora returned an inverted price on the BUY side (base/quote instead of quote/base), so the same pool reported, for example, 0.987 on BUY versus 1.012 on SELL. Prices are now consistently quoted in quote/base on both sides.
  • Real Uniswap pool balances: Uniswap CLMM pool-info was reporting Uniswap V3's virtual liquidity divided by token decimals as the token amounts, which is meaningless. It now returns the pool's real ERC20 balances via balanceOf, matching the on-chain TVL.
  • binCount on pool-info: The pool-info route now accepts an optional binCount parameter (Orca, Uniswap, Raydium) that returns a bins array describing the liquidity distribution—tick-spacing-wide bins centered on the active tick, each with its price and base/quote token amounts. This mirrors Meteora's existing bin shape across the other CLMM connectors. Default behavior is unchanged: binCount defaults to 0, so existing callers pay no extra RPC cost.
  • Extended Ethereum tx receipt polling: EVM transaction execution now polls for the receipt for an additional 90s after the initial timeout, so a healthy tx that needs a few more blocks to confirm is no longer reported as a failure.

PRs: #642, #635

🤖 OpenRouter LLM Support

Condor now supports OpenRouter as an LLM provider for /agent, giving you access to a large catalog of models through a single API key. OpenRouter also offers free models in the picker—select one with $0 pricing to use /agent without being charged.

How to use:

  1. Create an API key at openrouter.ai/keys
  2. Add OPENROUTER_API_KEY=sk-or-... to your Condor .env file and restart the bot
  3. In Telegram, run /agent → Change LLM → OpenRouter — Pick Model and select from the live catalog (free models show $0 pricing)

You can also choose Enter model manually and send an OpenRouter slug (for example anthropic/claude-sonnet-4-5, or openrouter/free for OpenRouter's free model router) if you already know which model you want.

PR: #82

📡 MQTT Bridge Migration

Migrated the remote MQTT bridge from commlib-py to aiomqtt, replacing paho's uncatchable disconnect errors with catchable reconnect logic on the event loop. Bots now recover automatically when the Hummingbot API broker restarts, without the degraded-performance issues seen on reconnect.

PR: #8293

📊 Condor & Web Dashboard

This release improves the Condor Telegram interface and web dashboard (/web), backed by new and updated Hummingbot API endpoints for bot lifecycle, analytics, and backtesting.

Dashboard & UI

  • condor #90 – UI upgrade across the Condor interface and web dashboard
  • condor #114 – Improved bots tab UI
  • condor #80 – Unified backend layer shared by Telegram and web
  • condor #118 – Fixed enum-prefixed config values and admin notification escaping, and added direct server assignment on approval

Bot Runs & Executors

Backtesting & Analytics

Notifications & Gateway Pools

  • condor #126 – Added notification system to routines
  • condor #76 – Added network-first pool management and default networks feature in the web dashboard
  • hummingbot-api #155 – Updated Gateway pool API to use chain and network organization and added RPC provider API key management endpoints

Other Updates

hummingbot/hummingbot

  • #8287 – Improved validation of dependent config model variables
  • #8282 – Removed require_kwargs_on_init causing Hummingbot API failures Thanks to mlguys! 🙏
  • #8220 – Improved candles error handling on shutdown
  • #8206 – Updated Gateway pool API to use chain and network organization
  • #8004 – Added message for invalid help command instead of crashing with error

hummingbot/gateway

  • #650 – Fixed Orca CLMM swap quote and execution panics on adaptive-fee whirlpools
  • #640 – Added sensible error handling to Gateway trading routes. Thanks to mlguys! 🙏
  • #637 – Surfaced InstructionError details in Solana simulation failures
  • #634 – Fixed pnpm v11 compatibility issues
  • #630 – Organized pool templates by network instead of connector

hummingbot/hummingbot-api

  • #159 – Fixed Gateway connector import, save_pool content-type, and FastAPI trailing-slash redirects

hummingbot/condor

  • #106 – Silenced httpx INFO logs to prevent Telegram bot token leakage
  • #102 – General upgrade and GitHub Actions improvements
  • #101 – Updated LP executor guide to align with current LPExecutorConfig schema
  • #97 – Fixed ACP agent to use npx for Gemini and Copilot CLI commands
  • #96 – Added voice settings
  • #91 – Removed Docker and related files