Skip to content
All library documents

Hummingbot 1.26: Strategy V2 Refactor and TWAP Execution

Article Hummingbot docs

Summary

Hummingbot 1.26 reorganizes its Strategy V2 framework around a unified market data provider. The provider gives multiple controllers access to historical candles, trades, and live order book data, which they can share while coordinating sub-strategies and automated executors. The release also introduces a TWAP executor that submits orders at regular time intervals, with rebalancing cited as one possible use. Its stated aim is to help limit market impact while pursuing a time-weighted average price.

The release notes document software features and integrations rather than trading results. They flag the TWAP executor as beta, so users should account for possible issues. The release also adds connectors for OKX perpetual markets, Kraken and Bitrue spot markets, and Osmosis, alongside connector guides. These broaden the venues and data sources available to Hummingbot users, but the notes do not compare venues or establish that any execution approach is profitable.

Key ideas

  • The refactored Strategy V2 framework provides a shared source for historical and real-time market data.
  • Multiple controllers can use shared data to coordinate sub-strategies and executors.
  • The TWAP executor places orders at regular intervals for uses such as rebalancing.
  • The release notes mark the TWAP executor as beta and provide no performance evaluation.
  • The update adds connectors for centralized exchanges and a decentralized exchange.

Tags

Full text
# Hummingbot v1.26.0 Release Notes


# Hummingbot v1.26.0 Release Notes

*Released on March 26, 2024*

## Introduction

We're delighted to unveil Hummingbot version 1.26.0! This release features a huge refactor to the [**Strategies V2**](../strategies/index.md) framework. We've significantly streamlined and simplified the architecture, updated the documentation and strategy examples, and added a new **TWAPExecutor** component that helps users execute trades while minimizing market impact.

**Also New in This Release**

* **OKX** perpetual CEX connector
* **Kraken** spot CEX connector (updated)
* **Bitrue** spot CEX connector
* **Osmosis** AMM DEX connector
* Connector guides to **Vega**, **Dexalot**, and **Osmosis**

| Repository | Description | GitHub Release | DockerHub Release |
|------------|-------------|----------------|-------------------|
| [Hummingbot](https://github.com/hummingbot/hummingbot) | Core Trading Engine | [`v1.26.0`](https://github.com/hummingbot/hummingbot/releases/tag/v1.26.0) | [`version-1.26.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-1.26.0) |
| [Gateway](https://github.com/hummingbot/gateway) | DEX Connector Middleware | [`v1.26.0`](https://github.com/hummingbot/gateway/releases/tag/v1.26.0) | [`version-1.26.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-1.26.0) |

## How to Update

### Docker

Clone the latest [`hummingbot/deploy-examples`](https://github.com/hummingbot/deploy-examples) repository and use the `hummingbot-update.sh` script under the `/bash_scripts` folder.

Alternatively, run the following command to pull the latest Docker image:

```
docker pull hummingbot/hummingbot:latest
```

### Source

Update your Hummingbot branch to this release by running:

```
git pull origin master
```

## Monthly Community Call

Join the next community call on [Discord](https://discord.gg/hummingbot) to learn about the new features in this release and other Hummingbot news:

* **Date**: Wednesday March 27
* **Time**: 4pm GMT / 12am SIN (March 28) / 11am EST / 8am PST 
* **Location**: [Hummingbot Discord](https://discord.gg/hummingbot)
* **Event Link**: <https://discord.gg/8TsJdCnc?event=1199751917715329064>

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

For more community events, check out the [Hummingbot Events Calendar](https://lu.ma/u/hummingbot).


## Improvements to Strategy V2 Framework
 
[![](../strategies/v2-strategies/diagrams/14.png)](../strategies/v2-strategies/diagrams/14.png)

We refactored the new Strategy V2 framework to make it simpler and more scalable. 

Now, the new Market Data Provider provides a single, unified point of access to a market's data, including historical candles, trades, and real-time order book data. Multiple controllers running individual sub-strategies can share this data and use it to control sophisticated, automated Executors.

Check out the new [Strategy V2 docs](../strategies/v2-strategies/index.md) for detailed walkthroughs, sample strategies, and more!

**Pull Request:**  [#6844](https://github.com/hummingbot/hummingbot/pull/6844)

## New TWAPExecutor Component

!!! Warning
    This component is still in beta and there may be some issues when using it. For more information on the reported issues or if you want to report a bug please submit them to our [Github - Issues](https://github.com/hummingbot/hummingbot/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml&title=Bug+Report) page

[TWAPExecutor](../strategies/v2-strategies/executors/twapexecutor.md) is a new Strategy V2 component that can be used by itself or combined with other components. It programmatically executes orders at regular time intervals, helping you achieve a time-weighted average price for rebalancing and other purposes.

**Pull Request:**  [#6915](https://github.com/hummingbot/hummingbot/pull/6915)

## New CEX Connectors: OKX Perpetual, Kraken, Bitrue

We're excited to introduce three connectors to the codebase. All were built by community developers with funding provided by approved Hummingbot Improvement Proposals:

* OKX Perpetual: New connector to OKX perpetual futures markets. See pull request [#6848](https://github.com/hummingbot/hummingbot/pull/6848) and **thanks to [tomasgaudino](https://github.com/tomasgaudino) for this contribution! 🙏**

* [Kraken](../exchanges/kraken/index.md): Updated connector to Kraken spot markets. See pull request [#6840](https://github.com/hummingbot/hummingbot/pull/6840) and **thanks to [yancong001](https://github.com/yancong001) for this contribution! 🙏**
 
* [Bitrue](../exchanges/bitrue.md): New connector to Bitrue spot markets. See pull request [#6843](https://github.com/hummingbot/hummingbot/pull/6843) and **thanks to [CoinAlpha](https://github.com/coinalpha) for this contribution! 🙏**

## New DEX/Chain Connector: Osmosis

[Osmosis](https://app.osmosis.zone/) is a decentralized exchange (DEX) built on the Cosmos blockchain, emphasizing interoperability and user sovereignty. It stands out for its advanced features, such as superfluid staking and liquidity pools with customizable parameters, allowing users to tailor their trading and staking strategies. Osmosis facilitates cross-chain transactions through the Inter-Blockchain Communication (IBC) protocol, enabling seamless swaps across a growing ecosystem of interconnected blockchains. 

For more information, see the Osmosis and Chain Connectors - Osmosis for the respective DEX and chain documentation pages.

**Pull Request:**  [#277](https://github.com/hummingbot/gateway/pull/277)

**Snapshot Proposal:** <https://snapshot.org/#/hbot-ncp.eth/proposal/0x2e159b270c17ac68f47774a7dc6741aab48b638274cfc6519d38b1847351901a>

**Thanks to [nkhrs](https://github.com/nkhrs) and [chasevoorhees](https://github.com/chasevoorhees) for their significant contribution to this integration! 🙏**

## New Connector Guides

In the last release, we introduced Connector Guides, step-by-step instructions that show users how to generate credentials on various centralized and decentralized exchanges and how to use them with Hummingbot.

This release introduces three new guides:

* Dexalot
* Vega
* Osmosis

We encourage community members to contribute more connector guides to <https://github.com/hummingbot/hummingbot-site>!

## Other Updates

### Hummingbot

 - [#6685](https://github.com/hummingbot/hummingbot/pull/6685) - Added Osmosis to native tokens list **Thanks to [chasevoorhees](https://github.com/chasevoorhees) for this fix! 🙏**
 - [#6884](https://github.com/hummingbot/hummingbot/pull/6884) - Upgraded `injective-py` version **Thanks to [aarmoa](https://github.com/aarmoa) for this fix! 🙏**
 - [#6903](https://github.com/hummingbot/hummingbot/pull/6903) - Included `MATIC` in the list of unwrapped symbols for price queries **Thanks to [OjusWiZard](https://github.com/OjusWiZard) for this fix! 🙏**
 - [#6908](https://github.com/hummingbot/hummingbot/pull/6908) - Fixed balance update for Injective **Thanks to [aarmoa](https://github.com/aarmoa) for this fix! 🙏**
 - [#6911](https://github.com/hummingbot/hummingbot/pull/6911) - Removed connector tiers

### Gateway

 - [#286](https://github.com/hummingbot/gateway/pull/286) - Refactored XRPL connector and added more improvements **Thanks to [mlguys](https://github.com/mlguys) 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.