Hummingbot 1.19 Adds Modular Strategies, Grid Trading, and Arbitrage Tools
Article Hummingbot docs
Summary
These release notes describe Hummingbot 1.19.0, focusing on a developing modular strategy framework and early dashboard tools for managing bots and backtests. The framework separates market data candles, controllers that choose actions, and executors that manage orders. New examples include a fixed grid that places orders at preset prices and can rebalance assets, plus a component for coordinating arbitrage across centralized and decentralized exchanges. The release also adds Injective spot and perpetual connectors and Tezos and Plenty connectivity.
The notes describe software capabilities rather than evidence of strategy performance. The V2 framework and dashboard are explicitly under active development, and the backtest manager is at an early stage with initial Optuna integration. The fixed grid and arbitrage descriptions explain intended operation but offer no returns, risk estimates, or comparative tests. Connector and account details may help practitioners assess implementation options, but users should not treat these release notes as validation of a trading edge.
Key ideas
- The V2 framework organizes strategies into candles, controllers, and execution components.
- A fixed grid example places orders at preset price levels and can rebalance assets.
- An arbitrage component coordinates trades across centralized and decentralized venues while tracking costs and profitability metrics.
- The dashboard and V2 framework are described as works in progress, and the release provides no strategy performance evidence.
Tags
Full text
# Hummingbot v1.19.0 Release Notes
# Hummingbot v1.19.0 Release Notes
*Released on August 28, 2023*
## Introduction
We're excited to present Hummingbot version 1.19.0! This release include the launch of the new **V2 Strategies** framework, major improvements to **Dashboard**, new sample scripts including the return of **Fixed Grid**, and new connectors to **Injective** (direct Python, no Gateway), the **Tezos** blockchain, and **Plenty** DEX on Tezos.
| Repository | Description | GitHub Release | DockerHub Release |
|------------|-------------|----------------|-------------------|
| [Hummingbot](https://github.com/hummingbot/hummingbot) | Core Trading Engine | [`v1.19.0`](https://github.com/hummingbot/hummingbot/releases/tag/v1.19.0) | [`version-1.19.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-1.19.0) |
| [Gateway](https://github.com/hummingbot/gateway) | DEX Connector Middleware | [`v1.19.0`](https://github.com/hummingbot/gateway/releases/tag/v1.19.0) | [`version-1.19.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-1.19.0) |
To install or update, clone the latest [`hummingbot/deploy-examples`](https://github.com/hummingbot/deploy-examples) repository and run the following Docker command:
```bash
docker compose up --force-recreate --build -d
```
!!! tip "New Start Command"
If you're using the source version, use the `./start` command to launch Hummingbot. [Read more](https://github.com/hummingbot/hummingbot/issues/6513).
## Monthly Community Call
Join our live community call on [Discord](https://discord.gg/hummingbot) to explore the new features. A recording will be available afterward.
[Join the Event](https://discord.gg/jZ4WJ78z?event=1138104671475605586){ .md-button .md-button--primary}
For more community events, check out the [Hummingbot Events Calendar](https://lu.ma/u/hummingbot).
## V2 Strategy Framework
!!! warning "Under Active Development"
V2 Strategies are still in active development and haven't been officially released yet. For those eager to explore, you can test the initial templates for directional and market-making strategies in this [pull request](https://github.com/hummingbot/hummingbot/pull/6520).
The new [V2 Strategy Framework](../strategies/v2-strategies/index.md) significantly expands Hummingbot's capabilities, allowing users to create modular, backtestable, and sophisticated strategies. Unlike the monolithic V1 strategies, V2 Strategies are designed to be highly adaptable, allowing seamless integration of various components. Whether you're a technical expert or a trading novice, you can easily create, backtest, and deploy strategies via [Dashboard](../dashboard/index.md).
We're introducing specialized templates for different trading paradigms, including Market Making, Directional, and future strategy types. These new strategy templates allow users to combine different composable components:
* Candles: These structure both historical and real-time market data into OHLCV format, generating refined signals for trading decisions.
* Controllers: These orchestrate the overall strategy, deciding which Executors to deploy or adjust based on signals generated by Candles.
* Executors: These are the operational elements that handle precise trade execution, adapt to market changes, and manage the order lifecycle.
Watch this video for a preview:
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/GhvTaIWHqrU?si=-3GT8hfAw0OuL7XK" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
You may also try out this [pull request](https://github.com/hummingbot/hummingbot/pull/6520).
## New Dashboard Features
!!! warning "Under Active Development"
Dashboard is still under active development. If you're excited to explore its initial capabilities, you can find the first version [here](https://github.com/hummingbot/dashboard).
The **Bot Orchestration** section enables you to effortlessly deploy and manage multiple instances of Hummingbot. Key updates include:
- **Master Bot Credentials**: Now you can use a single set of credentials to manage all your bot instances, streamlining the setup process.
- **Enhanced Bot Status Formatting**: We've added a specialized parser that neatly formats the status of running bots, making it easier to monitor their activity.
The **Backtest Manager** section is designed to help you fine-tune your trading strategies using historical data. This month, we started to add the initial components, including integration with the Optuna optimization framework and minimal versions of the initial pages.
Watch this video to see how to deploy Dashboard on AWS:
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/3WqNV543goI?si=-3GT8hfAw0OuL7XK" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
It's important to note that the Hummingbot Dashboard is currently in its beta phase, which means new features and improvements are being added continuously. While the Dashboard offers a variety of functionalities, it is not yet a polished, finalized product. We highly encourage user feedback at this stage; your insights can greatly help us fine-tune the Dashboard's capabilities and user experience. Feel free to share your thoughts and suggestions on Discord or Github.
## New Script Examples
Here are new script examples added to the codebase in this release, along with demo videos:
### Fixed Grid
[fixed_grid.py](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/fixed_grid.py): The script implements a fixed grid trading strategy, placing buy and sell orders at predetermined price levels, rebalancing assets if required, and providing status updates on trades and balances. **Pull Request:** [#6495](https://github.com/hummingbot/hummingbot/pull/6495)
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/1j81gP2ToCE?si=bl9IG5yQ0kTM2bTr" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
**Thanks to [rkc2000](https://github.com/rkc2000) for this script and video! 🙏**
### Wallet Hedging
[wallet_hedge_example.py](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/wallet_hedge_example.py): The script implements a fixed grid trading strategy, placing buy and sell orders at predetermined price levels, rebalancing assets if required, and providing status updates on trades and balances. **Pull Request:** [#6495](https://github.com/hummingbot/hummingbot/pull/6496)
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/BJl737HkXqs?si=t9ckDyHq9O4CXicx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
### Arbitrage with Smart Component
[arbitrage_with_smart_component.py](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/arbitrage_with_smart_component.py): The script defines an `ArbitrageWithSmartComponent` class that automates cryptocurrency arbitrage trading between CEX / DEX exchanges, ensuring sufficient balances and managing active and closed arbitrage executions. It uses [ArbitrageExecutor](../strategies/v2-strategies/executors/index.md), a new Hummingbot component designed to simplify and automate your arbitrage trading strategies. Part of the V2 Strategy Framework, this component is engineered to assess arbitrage profitability, execute buy and sell orders across multiple trading pairs, and provide real-time status updates. It also offers detailed metrics on profitability and transaction costs, along with configurable settings for arbitrage strategies.
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/VqJxpWZzCG4?si=t9ckDyHq9O4CXicx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
## New Chain/DEX Connectors: Tezos/Plenty
Expand your trading possibilities with our new connectors for the Tezos blockchain and Plenty decentralized exchange. [Tezos](https://tezos.com/) is a self-amending blockchain featuring on-chain governance and a liquid proof-of-stake consensus mechanism. [Plenty](https://plenty.network/) is a standout decentralized exchange and automated market maker (Dex & AMM) that operates on the Tezos platform.
[Tezos](https://tezos.com/) is a self-amending, decentralized blockchain platform with on-chain governance, emphasizing formal verification for smart contracts and utilizing a liquid proof-of-stake consensus mechanism. [Plenty](https://plenty.network/), is a leading decentralized exchange and automated market maker (Dex & AMM) on the Tezos blockchain.
See Tezos for the chain docs and the Plenty exchange connector docs.
**Pull Requests:** [#156](https://github.com/hummingbot/gateway/pull/156), [#6475](https://github.com/hummingbot/hummingbot/pull/6475)
**Snapshot Proposal:** <https://snapshot.org/#/hbot-ncp.eth/proposal/0x86cecae5e1f31055559d51a30319a6b781dd1b6004527702a1a7ba2bce621291>
**Thanks to [OjusWiZard](https://github.com/OjusWiZard) for this contribution! 🙏**
## New Injective spot and perpetual Connectors
We've rolled out Python-native connectors that eliminates the need for Gateway when trading on Injective. In addition, These connectors are optimized for delegated accounts, allowing you to hold your funds in a primary account (portfolio or granter account) while signing trades and transactions with a separate trading account. The advantage? You can run multiple Hummingbot instances using the same pool of funds but different trading accounts, thus avoiding sequence number conflicts.
See the [Injective](../exchanges/injective.md) documentation for more information.
**Pull Requests:** [#6512](https://github.com/hummingbot/hummingbot/pull/6512), [#6521](https://github.com/hummingbot/hummingbot/pull/6521), [#6493](https://github.com/hummingbot/hummingbot/pull/6493)
**Snapshot Proposal:**
**Thanks to [aarmoa](https://github.com/aarmoa) for this contribution! 🙏**
## Other Updates
### Hummingbot
* [#6439](https://github.com/hummingbot/hummingbot/pull/6439) Added a logger mixin for tests **Thanks to [MementoRC](https://github.com/MementoRC) for this fix! 🙏**
* [#6455](https://github.com/hummingbot/hummingbot/pull/6455) Added a `wait for tasks` method that allows to await calls made via `safe_wrapper` **Thanks to [MementoRC](https://github.com/MementoRC) for this fix! 🙏**
* [#6456](https://github.com/hummingbot/hummingbot/pull/6456) Refactored [BTCMarkets](../exchanges/btc-markets.md) test cases **Thanks to [vdmerweandre](https://github.com/vdmerweandre) for this fix! 🙏**
* [#6457](https://github.com/hummingbot/hummingbot/pull/6457) Updated workflow actions to latest version **Thanks to [MementoRC](https://github.com/MementoRC) for this fix! 🙏**
* [#6496](https://github.com/hummingbot/hummingbot/pull/6496) Added hedging logic to data feed that tracks wallet balances for certain tokens
* [#6498](https://github.com/hummingbot/hummingbot/pull/6498) Added additional on-the-fly params **Thanks to [ntenisOT](https://github.com/ntenisOT) for this fix! 🙏**
* [#6501](https://github.com/hummingbot/hummingbot/pull/6501) Fixed Binance rate limit weight for ticker price change **Thanks to [supervik](https://github.com/supervik) for this fix! 🙏**
* [#6504](https://github.com/hummingbot/hummingbot/pull/6504) Fixed leverage type from `decimal` to `int`
* [#6518](https://github.com/hummingbot/hummingbot/pull/6518) Added start command for source version which fixes [#6513](https://github.com/hummingbot/hummingbot/issues/6513)
* [#6519](https://github.com/hummingbot/hummingbot/pull/6519) Updated Dexalot connector **Thanks to [CoinAlpha](https://github.com/coinalpha) for this contribution! 🙏**
* [#6527](https://github.com/hummingbot/hummingbot/pull/6527) Fixed rebalance order price bug in fixed grid script **Thanks to [rkc2000](https://github.com/rkc2000) for this contribution! 🙏**
### Gateway
* [#169](https://github.com/hummingbot/gateway/pull/169) Fixed issue with `UniswapLP - failed to remove liquidity` **Thanks to [vic-en](https://github.com/vic-en) for this fix! 🙏**
* [#178](https://github.com/hummingbot/gateway/pull/178) Updated `Gateway API.json` to use `chain` endpoints
* [#181](https://github.com/hummingbot/gateway/pull/181) Fixed Gateway version
* [#182](https://github.com/hummingbot/gateway/pull/182) Refactored `arbitrum_one` to `arbitrum` to fix issue reported in [#173](https://github.com/hummingbot/gateway/issues/173) **Thanks to [isreallee82](https://github.com/isreallee82) for this fix! 🙏**
* [#188](https://github.com/hummingbot/gateway/pull/188) Fixed Gateway testsShown 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.