Skip to content
All library documents

Hummingbot 1.24: Configurable Scripts and Sample Trading Strategies

Article Hummingbot docs

Summary

This release overview describes Hummingbot 1.24 features for building and operating algorithmic trading strategies. Scripts can now define parameters in a configuration class and load them from YAML files, making settings easier to modify and share. The release also presents sample V2 strategies: BollingerV1 uses Bollinger Band Percent for directional signals, Trend Follower combines that measure with a simple moving average, and DManV4 adjusts market-making spreads using normalized average true range (NATR).

The release adds Vega Protocol and QuipuSwap decentralized exchange connectors and updates connector-development documentation. These are platform capabilities rather than evidence for a trading edge. The notes do not report backtests, live results, or risk-adjusted performance for the sample strategies, and give little detail on their entry, exit, or risk rules. The material is most useful as a description of strategy building blocks and configurable infrastructure; assessing any strategy requires further specification and independent testing.

Key ideas

  • Script parameters can be defined in a configuration class and stored in YAML files.
  • BollingerV1 uses Bollinger Band Percent to construct directional signals.
  • The Trend Follower sample combines a simple moving average with Bollinger Band Percent.
  • DManV4 uses normalized average true range to adjust market-making spreads.
  • The release describes new exchange connectivity and developer documentation but gives no strategy performance evidence.

Tags

Full text
# Hummingbot v1.24.0 Release Notes


# Hummingbot v1.24.0 Release Notes

*Released on January 29, 2024*

## Introduction

As we step into a new year full of infinite possibilities, we are thrilled to present Hummingbot version 1.24.0! A major highlight of this version are **configurable scripts**, which lets users create config files for V2 Strategies and basic scripts just like they can for V1 Strategies. We also added more **sample V2 strategies**, including the new **DmanV4** advanced market making strategy.

This release also features substantial documentation updates, especially for exchange connector development and governance! Finally, we're excited to introduce two fresh DEX connectors: **Vega Protocol** and **QuipuSwap**, ensuring a broader range of trading opportunities for Hummingbot users across the DeFi landscape.

| Repository | Description | GitHub Release | DockerHub Release |
|------------|-------------|----------------|-------------------|
| [Hummingbot](https://github.com/hummingbot/hummingbot) | Core Trading Engine | [`v1.24.0`](https://github.com/hummingbot/hummingbot/releases/tag/v1.24.0) | [`version-1.24.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-1.24.0) |
| [Gateway](https://github.com/hummingbot/gateway) | DEX Connector Middleware | [`v1.24.0`](https://github.com/hummingbot/gateway/releases/tag/v1.24.0) | [`version-1.24.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-1.24.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 January 31
* **Time**: 4pm GMT / 12am SIN (Feb 1) / 11am EST / 8am PST 
* **Location**: [Hummingbot Discord](https://discord.gg/hummingbot)
* **Event Link**: <https://discord.gg/8TsJdCnc?event=1199751917715329064>

Afterwards, we will publish the recording on the Hummingbot YouTube and post it here.

<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/_Yh_vdC-YY0" 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).

## Configurable Scripts

Ever since we introduced [Scripts](../strategies/scripts/index.md) as a lightweight way to create simple trading strategies, users have been asking for the ability to add configuration files for them, as they are able to do for V1 Strategies. Now, they finally can!

Starting in this release, scripts can define a `ScriptConfig` class that defines configuration parameters that users can store in a YAML file. Both V2 Scripts used to control V2 Strategies as well as more basic scripts can add this class with a few lines of code. Afterwards, users can create config files for scripts, which can be modified and shared easily.

See [Config Files](../client/config-files.md#script-config-files) for details on how to use this feature.

## New Sample V2 Strategies

Hummingbot's new [V2 Strategies](../strategies/v2-strategies/index.md) allow users to create powerful custom strategies by configuring LEGO-like components as building blocks. In this release, we have added a page with a list of [Sample Strategies](../strategies/v2-strategies/examples/index.md) that users can extend and modify.

In addition, we've also added a few new sample strategies:

### BollingerV1

A simple directional strategy that uses Bollinger Band Percent (BBP), which measures an asset's price relative to its upper and lower Bollinger Bands, to construct long/short signals.

### Trend Follower

A simple trend-following strategy that uses Simple Moving Average (SMA) and Bollinger Band Percent (BBP) to construct long/short signals.

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

### DManV4

The new [**DManV4**](https://github.com/hummingbot/hummingbot/blob/development/strategies/scripts/v2_dman_v4_multiple_pairs.py) strategy is a sophisticated market making strategy that utilizes Natural True Range (NATR) to dynamically set spreads, along with various advanced parameters for more nuanced controls.

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

## Connector Development and Governance Docs

This release features a revamped Building Connectors section for developers building connectors to order book spot and perpetual exchanges. We've added pages tthat describe the latest spot and perpetual connector standards, developer and QA checklists, as well as debugging and troubleshooting docs.

In addition, we have also revised the Polls section to reflect the changes approved in [HGP-50](https://snapshot.org/#/hbot.eth/proposal/0xc13f3b9fdaded22d1ce0b5528c9146fb2a762c41deed88e6c64e798465414738), which replaced the legacy Gold/Silver/Bronze maintenance tiers with a new system that allocate HBOT bounties among the connectors for each Poll based on their pro-rata voting share. Each connector may have a public HBOT maintenance bounty allocation which the Foundation will use to fund bounties for bug fixes and upgrades related to that exchange's Hummingbot connector that can be assigned to community developers.

## New DEX Connector: Vega Protocol

[Vega Protocol](https://vega.xyz/) is a new DEX built from the ground up using high performing, purpose-built smart contracts specifically for trading - meaning no fees on orders, and fairness at its core. It operates on the Vega Alpha Mainnet, a Tendermint based blockchain. For more information, see the Vega connector docs.

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

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

**Thanks to [R-K-H](https://github.com/R-K-H) for their significant contribution to this integration! 🙏**


## New DEX Connector: QuipuSwap

[QuipuSwap](https://quipuswap.com/), is a decentralized exchange (DEX) on the Tezos blockchain. It features on-chain governance for baking rewards, emphasizing user participation in decision-making processes. QuipuSwap offers a platform for seamless token swaps and liquidity provision, catering to users engaged in the Tezos ecosystem. For more information, see the QuipuSwap connector docs.

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

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

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

## Other Updates

### Hummingbot

- [#6719](https://github.com/hummingbot/hummingbot/pull/6719) - Adjusted limit price representation for small amounts **Thanks to [isreallee82](https://github.com/isreallee82) for this fix! 🙏**
- [#6749](https://github.com/hummingbot/hummingbot/pull/6749) - Simplified funding loop **Thanks to [MementoRC](https://github.com/MementoRC) for this fix! 🙏**
- [#6755](https://github.com/hummingbot/hummingbot/pull/6755) - Added config parameter to `./start` command
- [#6760](https://github.com/hummingbot/hummingbot/pull/6760) - Refactored [Injective](../exchanges/injective.md) connectors to use the new chain streams **Thanks to [aarmoa](https://github.com/aarmoa) for this fix! 🙏**
- [#6785](https://github.com/hummingbot/hummingbot/pull/6785) - Fixed directional script bugs and added configurable PMM script
- [#6789](https://github.com/hummingbot/hummingbot/pull/6789) - Fixed `unexpected_error_while_processing_event_201` for [Hyperliquid](../exchanges/hyperliquid.md) **Thanks to [yancong001](https://github.com/yancong001) for this fix! 🙏** 
- [#6790](https://github.com/hummingbot/hummingbot/pull/6790) - Fixed error on submit market order due to reduce only order would increase position **Thanks to [yancong001](https://github.com/yancong001) for this fix! 🙏** 
- [#6795](https://github.com/hummingbot/hummingbot/pull/6795) - Updated [MEXC](../exchanges/mexc/index.md) broker ID


### Gateway

- [#251](https://github.com/hummingbot/gateway/pull/251) - Added [PancakeSwap](../exchanges/gateway/pancakeswap.md) V3 price calculation **Thanks to [0xcodercrane](https://github.com/0xcodercrane) for this fix! 🙏** 
- [#266](https://github.com/hummingbot/gateway/pull/266) - Fixed [Dexalot](../exchanges/dexalot.md) issue where `EUROC` and `sAVAX` balances are not recognized  **Thanks to [vic-en](https://github.com/vic-en) for this fix! 🙏** 
- [#272](https://github.com/hummingbot/gateway/pull/272) - Changed default `gasPrice` value for Kujira **Thanks to [danilo-silva-funttastic](https://github.com/danilo-silva-funttastic) 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.