Hummingbot 2.8.0: DEX Schemas, Swap Safety, and Connector Changes
Article Hummingbot docs
Summary
These release notes describe Hummingbot and Gateway version 2.8.0, with the main change being a Gateway architecture refactor for decentralized exchange trading. Connectors are organized around router, automated market maker, and concentrated liquidity schemas. The release also adds wallet, swap, liquidity, token, pool, and configuration commands within the client, and updates integrations for several DEXs, including Jupiter, Meteora, Raydium, and Uniswap.
Trading-related safeguards include transaction simulation and slippage protection, alongside hardware wallet support for Ethereum and Solana. The notes also mention a centralized exchange connector, improved trade updates, and a server interface for connecting Hummingbot to AI and automation tools. This is a software release overview, not a strategy guide: it provides no trading performance data or comparative evaluation of connectors. Some listed legacy connectors are described as ready for implementation of the new schema, so the release notes do not establish that every named integration has already been migrated.
Key ideas
- Gateway organizes DEX integrations around router, AMM, and concentrated-liquidity schemas.
- The Hummingbot client adds commands for wallet management, swaps, and liquidity operations.
- Transaction simulation and slippage protection are among the described safety features.
- The release notes do not provide evidence about strategy performance or execution quality.
Tags
Full text
# Hummingbot v2.8.0 Release Notes
# Hummingbot v2.8.0 Release Notes
*Released on August 21, 2025*
| Repository | Description | GitHub Release | DockerHub Release |
|------------|-------------|----------------|-------------------|
| [Hummingbot](https://github.com/hummingbot/hummingbot) | Core Client | [`v2.8.0`](https://github.com/hummingbot/hummingbot/releases/tag/v2.8.0) | [`version-2.8.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-2.8.0) |
| [Gateway](https://github.com/hummingbot/gateway) | DEX Middleware | [`v2.8.0`](https://github.com/hummingbot/gateway/releases/tag/v2.8.0) | [`version-2.8.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-2.8.0) |
!!! note
Other Hummingbot repositories such as [Dashboard](https://github.com/hummingbot/dashboard), [Hummingbot-API](https://github.com/hummingbot/hummingbot-api), [Hummingbot API Client](https://github.com/hummingbot/hummingbot-api-client), [Quants-Lab](https://github.com/hummingbot/quant-lab), [Deploy](https://github.com/hummingbot/deploy) and the newly released [Hummingbot MCP](https://github.com/hummingbot/mcp) follow a continuous deployment model without fixed version releases. Use the `main` branch for these repositories.
See the full changelogs on GitHub:
- [Hummingbot v2.8.0 Changelog](https://github.com/hummingbot/hummingbot/releases/tag/v2.8.0)
- [Gateway v2.8.0 Changelog](https://github.com/hummingbot/gateway/releases/tag/v2.8.0)
## How to Update
### Docker
Re-run the [Deploy](https://github.com/hummingbot/deploy) setup script:
```bash
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:
```bash
docker compose down
docker pull hummingbot/hummingbot:latest
docker compose up -d
```
### Source
Update the branches of each repo to this release by running:
```bash
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](../installation/hummingbot-client.md) and [Install Gateway from Source](../gateway/installation.md).
## Release Highlights
### 🔗 Gateway 2.8.0 - Major Architecture Refactor
This release completes the [NCP-22](https://snapshot.box/#/s:hbot-ncp.eth/proposal/0xce92e088bb088e66e17f6c26b07643f1dcb3c0e57c8d3e93b80e37e6c92e7ebf) 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**](../gateway/connectors.md#router-schema): DEX aggregators (Jupiter, 0x, Uniswap Router) that find optimal swap routes
- [**AMM Schema**](../gateway/connectors.md#amm-schema): Traditional V2-style constant product pools (Raydium AMM, Uniswap V2)
- [**CLMM Schema**](../gateway/connectors.md#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](https://tokenlists.org/) standard
- Pool definitions in `/conf/pools/{connector}.json` for each DEX
- Network-specific YAML files for chain configurations
- See [Configuration Guide](../gateway/configuration.md) for details
#### 🎮 Gateway Commands in Hummingbot
Added comprehensive [Gateway commands](../gateway/commands.md) 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](../exchanges/gateway/jupiter.md)**: Complete rewrite with Router schema, improved route finding and error handling
* **[Meteora](../exchanges/gateway/meteora.md)**: New DLMM (Dynamic Liquidity Market Maker) support with CLMM schema
* **[Raydium](../exchanges/gateway/raydium.md)**: Dual support for AMM V2 pools and CLMM V3 concentrated liquidity
* **[Uniswap](../exchanges/gateway/uniswap.md)**: 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:
* **[PancakeSwap](../exchanges/gateway/pancakeswap.md)** - BNB Chain AMM/CLMM ([Bounty #7654](https://github.com/hummingbot/hummingbot/issues/7654))
* **[Balancer](../exchanges/gateway/balancer.md)** - Multi-asset AMM pools ([Bounty #7653](https://github.com/hummingbot/hummingbot/issues/7653))
* **[Curve](../exchanges/gateway/curve.md)** - Stablecoin-optimized AMM ([Bounty #7652](https://github.com/hummingbot/hummingbot/issues/7652))
* **[SushiSwap](../exchanges/gateway/sushiswap.md)** - Multi-chain AMM/CLMM
* **[QuickSwap](../exchanges/gateway/quickswap.md)** - Polygon AMM/CLMM
* **[TraderJoe](../exchanges/gateway/traderjoe.md)** - Avalanche AMM/CLMM
* **[ETCSwap](../exchanges/gateway/etcSwap.md)** - Ethereum Classic AMM
See the [DEX Connectors](../gateway/connectors.md) 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](../gateway/index.md)**: Complete rewrite with practical guides and examples
* **[Gateway Strategies](../gateway/strategies.md)**: New scripts demonstrating AMM Data Feed, AMM Trade, and LP Position Management
* **[Chain Schemas](../gateway/chains.md#chain-schema)**: Standardized request/response schemas for all blockchain operations
#### 🚀 Migration Guide
For users upgrading from Gateway v2.7 or earlier, see the [Gateway Installation Guide](../gateway/installation.md) 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](https://github.com/modelcontextprotocol).
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](https://github.com/hummingbot/mcp)
📚 Documentation: [Hummingbot MCP Overview](https://github.com/hummingbot/mcp#readme)
### 🏦 Foxbit CLOB CEX Connector
- Based on approval from [community voting](https://snapshot.box/#/s:hbot-ncp.eth/proposal/0x01022a516c3536d015e21b28e90204a7dbc4a65b42c0e2d568847509f7531e6a), the [Foxbit](../exchanges/foxbit/index.md) exchange connector was added back in [#7680](https://github.com/hummingbot/hummingbot/pull/7680).
### Other Updates
**hummingbot/deploy**
* [#101](https://github.com/hummingbot/deploy/pull/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](https://github.com/hummingbot/hummingbot-api/pull/75) - Improved the controller configuration routes
**hummingbot/dashboard**
* [#253](https://github.com/hummingbot/dashboard/pull/253) - Improved the controller configuration (same as PR#75)
* [#258](https://github.com/hummingbot/dashboard/pull/258) - Fixed a `KeyError` that occurred when token balances were zero.
* [#259](https://github.com/hummingbot/dashboard/pull/259) - Renamed Backend-API references to Hummingbot-API.
**hummingbot/hummingbot**
* [#7343](https://github.com/hummingbot/hummingbot/pull/7343) - Improved trade updates for Hyperliquid **Thanks to [isreallee82](https://github.com/isreallee82) for this fix! 🙏**
* [#7670](https://github.com/hummingbot/hummingbot/pull/7670) - Added spot candles feed for BTC Markets **Thanks to [jrcalzada-nginio](https://github.com/jrcalzada-nginio) for this fix! 🙏**
* [#7711](https://github.com/hummingbot/hummingbot/pull/7711) - Minor improvements across core modules such as `market data provider`, `v1 strategy config` and `performance monitoring`
* [#7722](https://github.com/hummingbot/hummingbot/pull/7722) - Fixed the `HEADLESS_MODE` environment variable issue **Thanks to [petioptrv](https://github.com/petioptrv) for this fix! 🙏**Shown in full with attribution under the source's licence. Licence: Apache-2.0
This summary was written by Stratmill's research agent from the original; it is not a copy of the source.