Skip to content

Hummingbot v2.8.0 Release Notes

Released on August 21, 2025

Repository Description GitHub Release DockerHub Release
Hummingbot Core Client v2.8.0 version-2.8.0
Gateway DEX Middleware v2.8.0 version-2.8.0

Note

Other Hummingbot repositories such as Dashboard, Hummingbot-API, Hummingbot API Client, Quants-Lab, Deploy and the newly released Hummingbot MCP 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 2.8.0 - Major Architecture Refactor

This release completes the NCP-22 Gateway refactor, introducing a completely revamped architecture with standardized schemas, native Gateway commands in Hummingbot, and modernized DEX connectors.

🏗️ Architecture Overhaul

Standardized Schemas: Implemented three universal trading schemas across all DEX connectors:

  • Router Schema: DEX aggregators (Jupiter, 0x, Uniswap Router) that find optimal swap routes
  • AMM Schema: Traditional V2-style constant product pools (Raydium AMM, Uniswap V2)
  • CLMM Schema: V3-style concentrated liquidity pools (Meteora DLMM, Raydium CLMM, Uniswap V3)

New Configuration System:

  • Token lists now stored in /conf/tokens/{chain}/{network}.json following tokenlists.org standard
  • Pool definitions in /conf/pools/{connector}.json for each DEX
  • Network-specific YAML files for chain configurations
  • See Configuration Guide for details

🎮 Gateway Commands in Hummingbot

Added comprehensive Gateway commands directly in the Hummingbot client:

  • Wallet Management: gateway connect, gateway balance - Connect wallets and check balances
  • Trading: gateway swap - Execute swaps with quotes and slippage protection
  • Liquidity: gateway lp - Manage AMM and CLMM liquidity positions
  • Configuration: gateway token, gateway pool, gateway config - Manage tokens, pools, and settings
  • Monitoring: gateway ping, gateway list - Check connection status and available connectors

🔄 Revamped DEX Connectors

  • Jupiter: Complete rewrite with Router schema, improved route finding and error handling
  • Meteora: New DLMM (Dynamic Liquidity Market Maker) support with CLMM schema
  • Raydium: Dual support for AMM V2 pools and CLMM V3 concentrated liquidity
  • Uniswap: Migrated to Universal Router with support for V2 AMM, V3 CLMM, and Smart Order Router

🛠️ Legacy Connector Updates

Standardized existing Gateway connectors to align with the new architecture. The following connectors are ready for v2.8.0 schema implementation with bounties available:

See the DEX Connectors page for full details on upgrading these connectors to the v2.8.0 standard.

🔐 Security & Infrastructure

  • Hardware Wallet Support: Full Ledger integration for Ethereum and Solana chains
  • Transaction Safety: Added simulation, connector-specific settings, and slippage protection
  • Error Handling: Improved error messages and recovery mechanisms across all connectors
  • Integration: Transaction handling and data storage in Hummingbot

📚 Documentation & Developer Experience

  • Swagger API: Enhanced API documentation available at http://localhost:15888/docs in DEV mode
  • Gateway Documentation: Complete rewrite with practical guides and examples
  • Gateway Strategies: New scripts demonstrating AMM Data Feed, AMM Trade, and LP Position Management
  • Chain Schemas: Standardized request/response schemas for all blockchain operations

🚀 Migration Guide

For users upgrading from Gateway v2.7 or earlier, see the Gateway Installation Guide for complete setup instructions.

🤖 Hummingbot MCP Server

We introduced the Hummingbot MCP (Model Context Protocol) Server, a new server module that connects Hummingbot with AI agents, automation frameworks, and external tools via the MCP standard.

Key highlights:

  • AI-Powered Control: Exposed bot and strategy management through MCP-compatible clients (e.g., Claude, Gemini, Cursor).
  • API Integration: Acted as a middleware layer between the Hummingbot API and AI/automation clients.
  • Docker Deployment: Added official Docker images for fast setup.

📦 Repository: github.com/hummingbot/mcp

📚 Documentation: Hummingbot MCP Overview

🏦 Foxbit CLOB CEX Connector

Other Updates

hummingbot/deploy

  • #101 - Improved the setup script to ensure the compose file was updated when users changed the default admin username or password

hummingbot/hummingbot-api

  • #75 - Improved the controller configuration routes

hummingbot/dashboard

  • #253 - Improved the controller configuration (same as PR#75)
  • #258 - Fixed a KeyError that occurred when token balances were zero.
  • #259 - Renamed Backend-API references to Hummingbot-API.

hummingbot/hummingbot

  • #7343 - Improved trade updates for Hyperliquid Thanks to isreallee82 for this fix! 🙏
  • #7670 - Added spot candles feed for BTC Markets Thanks to jrcalzada-nginio for this fix! 🙏
  • #7711 - Minor improvements across core modules such as market data provider, v1 strategy config and performance monitoring
  • #7722 - Fixed the HEADLESS_MODE environment variable issue Thanks to petioptrv for this fix! 🙏