Hummingbot 2.3 Adds Grid and Cross-Exchange Market-Making Strategies

# Hummingbot v2.3.0 Release Notes


# Hummingbot v2.3.0 Release Notes

*Released on February 3, 2025*

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

!!! note
    Other Hummingbot repositories such as [Dashboard](https://github.com/hummingbot/dashboard), [Backend-API](https://github.com/hummingbot/backend-api), [Quant-Lab](https://github.com/hummingbot/quant-lab), and [Deploy](https://github.com/hummingbot/deploy) follow a continuous deployment model without fixed version releases. Use the `main` branch for these repositories.

See the full changelogs on GitHub:

- [Hummingbot v2.3.0 Changelog](https://github.com/hummingbot/hummingbot/releases/tag/v2.3.0)
- [Gateway v2.3.0 Changelog](https://github.com/hummingbot/gateway/releases/tag/v2.3.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

### Ongoing Refactor of Gateway DEX Connectors

With the exponential rise of DEX trading in recent months on Solana, the Gateway middleware needed to be refactored to support Solana DEXs, enable Concentrated Liquidity Market Making (CLMM) strategies, and modernize the tech stack. This is a multi-month effort to improve the Gateway middleware and make it more efficient, secure, and easier to maintain. See [NCP-22](https://snapshot.box/#/s:hbot-ncp.eth/proposal/0x5cc3540ee219787d5c842bc1ccdb11aab46203bb7f0be658b6b40858501a8e4c) for more details.

In this release, we have streamlined the Gateway codebase to focus on two chain architectures: Solana and Ethereum. Ethereum L2 networks like Base along with EVM-compatible chains like Avalanche, Polygon, and BSC are now handled by the Ethereum chain connector, while Solana and other SVM-compatible chains are handled by the Solana chain connector. We have also refactored the Uniswap DEX connector to use this new Ethereum class and added a Jupiter DEX connector on Solana.

As part of the Gateway refactor, we've upgraded the underlying web framework from Express to Fastify. This modernization brings several key benefits including automatic OpenAPI/Swagger documentation generation for all API endpoints, significantly improved performance compared to Express, built-in request Typescript validation.

In the next release, we plan to add support for Meteora and Raydium as CLMM DEX connectors on Solana, and enhance the Uniswap connector with LP functionality. The Gateway middleware will standardize CLMM endpoints across all supported DEXs to provide a unified interface for liquidity provision. We will also publish comprehensive documentation to help the community migrate their custom DEX connectors to the new Gateway architecture.

Check out one of our recent weekly Youtube livestream demo to see the new Meteora connector in action!

<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/VxKSPgotPhg?si=LkdJW1U7ZEQ" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Pull Requests: [Hummingbot - #7367](https://github.com/hummingbot/hummingbot/pull/7367) | [Gateway -#380](https://github.com/hummingbot/gateway/pull/380) 


### New Cross-Exchange Market Making (XEMM) V2 Controller

This release introduces a new V2-compatible version of the Cross Exchange Market Making (XEMM) strategy, one of Hummingbot's original core strategies. The new implementation provides users with greater flexibility and control over their market making activities across different exchanges. Users can now configure multiple order levels, monitor performance through Dashboard, and run multiple XEMM instances concurrently.

See the [`xemm_multiple_levels` controller](https://github.com/hummingbot/hummingbot/blob/master/controllers/generic/xemm_multiple_levels.py) for the new implementation, which can be initialized with the `v2_with_controllers` script like other V2 controllers.

Pull Request: [Hummingbot #7369](https://github.com/hummingbot/hummingbot/pull/7369)

### New GridStrike V2 Controller

This release also introduces a new strategy, `GridStrike`, that combines aspects of grid trading, market making, and directional trading into a single advanced strategy. It allows users to maintain a grid of buy and sell orders around the current price of an asset with inventory-based risk management.

See the [`grid_strike` controller](https://github.com/hummingbot/hummingbot/blob/master/controllers/generic/grid_strike.py) for the new implementation, which can be initialized with the `v2_with_controllers` script like other V2 controllers. 

Pull Request: [Hummingbot #7374](https://github.com/hummingbot/hummingbot/pull/7374)

### New BingX Spot Connector

This release adds support for BingX spot markets in [Hummingbot #7280](https://github.com/hummingbot/hummingbot/pull/7280). This [proposal](https://snapshot.box/#/s:hbot-ncp.eth/proposal/0xac46cb41a8f66e7cb13f99471da7c8d1bd2c47f81e3743be60e667638e4ac436) was submitted by [Robotter Labs](https://labs.robotter.ai) in collaboration with BingX, aiming to enhance Hummingbot's capabilities by integrating BingX Exchange. See the [BingX](../exchanges/bing_x/index.md) documentation for more information. 

**Thanks to [danilo-robotter-ai](https://github.com/danilo-robotter-ai) for this contribution! 🙏**

### New Bitmart Perpetual Connector

We are excited to announce the addition of Bitmart as a new exchange partner of Hummingbot Foundation. Bitmart is a leading global digital asset trading platform that provides spot and derivatives trading services to over 9 million users worldwide When you run Hummingbot on Bitmart, a portion of your trading fees automatically goes to support the Foundation at no additional cost to you.

This release adds support for a Bitmart perpetual connector in [Hummingbot #7368](https://github.com/hummingbot/hummingbot/pull/7368) with the [bounty](https://github.com/hummingbot/hummingbot/issues/7323), funded by the Bitmart team. See the [Bitmart](../exchanges/bitmart/index.md) documentation for more information.

**Thanks to [tomasgaudino](https://github.com/tomasgaudino) for this contribution! 🙏**


### Improvements to Existing Exchange Connectors

- [#7333](https://github.com/hummingbot/hummingbot/pull/7333) - Added rate_oracle for the `Tegro` connector **Thanks to [isreallee82](https://github.com/isreallee82) for this fix! 🙏**
- [#7362](https://github.com/hummingbot/hummingbot/pull/7362) - Fixed the issue with `Hyperliquid` Perpetual reduce only issue **Thanks to [yancong001](https://github.com/yancong001) for this fix! 🙏**
- [#7373](https://github.com/hummingbot/hummingbot/pull/7373) - Fixed issue with `Bybit` updating trade fees **Thanks to [leocape](https://github.com/leocape) for this contribution! 🙏**
- [#7391](https://github.com/hummingbot/hummingbot/pull/7391) - Fixed the `unexpected private key length` error on `Dexalot` using the v2_with_controllers script **Thanks to [klpanagi](https://github.com/klpanagi) for this fix! 🙏**
- [#7398](https://github.com/hummingbot/hummingbot/pull/7398) - Fixed issue with adding `Bybit` Spot API keys **Thanks to [usamike25](https://github.com/usamike25) for this fix! 🙏**


### Other Updates

**Hummingbot**

- [#7369](https://github.com/hummingbot/hummingbot/pull/7369) - Added some improvements to the `xemm` executor 
- [#7374](https://github.com/hummingbot/hummingbot/pull/7374) - Fixed typo in README  **Thanks to [harmamiika](https://github.com/harmamiika) for this contribution! 🙏**
- [#7377](https://github.com/hummingbot/hummingbot/pull/7377) - Fixed typo in Makefile for `coinbase_advanced_trade` tests to exclude dir  
- [#7382](https://github.com/hummingbot/hummingbot/pull/7382) - Fixed typo in README **Thanks to [crStiv](https://github.com/crStiv) for this contribution! 🙏**
- [#7384](https://github.com/hummingbot/hummingbot/pull/7384) - Updated docs URL to `https://hummingbot.org/docs/`
- [#7387](https://github.com/hummingbot/hummingbot/pull/7387) - Added feature to stop executor with `keep_position` feature  


**Gateway**

- [#398](https://github.com/hummingbot/gateway/pull/398) - Fixed broken link in README **Thanks to [gordonkoehn](https://github.com/gordonkoehn) for this contribution! 🙏** 
- [#404](https://github.com/hummingbot/gateway/pull/404) - Updated dependencies in Dockerfile and yarn.lock file