1.20.0 - Hummingbot

URL: https://hummingbot.org/release-notes/1.20.0/

Contents:

• Hummingbot v1.20.0 Release Notes¶
• Introduction¶
• Monthly Community Call¶
• V2 Strategy Framework¶
• New Dashboard Features¶
• Hummingbot Library¶
• Update Cython version to 3.0¶
• New Chain and DEX Connector: Kujira¶
• New CEX Connector: Woo X¶
• New Rate Oracle Source: CoinCap¶

Released on October 02, 2023

We're thrilled to present Hummingbot version 1.20.0! This latest iteration introduces the V2 strategy framework which enables backtest-able, multi-bot strategies. For developers and advanced users, the Hummingbot Python Library has been rolled out. We've also integrated CoinCap as a new rate oracle source and expanded the list of connectors with Woo X and Kujira.

To update to the latest version, clone the latest hummingbot/deploy-examples repository and use the hummingbot-update.sh script under the /bash_scripts folder or run the following Docker command to pull the latest image:

If you're using the source version, use the ./start command to launch Hummingbot.

Here is the recording of the event:

For more community events, check out the Hummingbot Events Calendar.

Hummingbot's V2 Strategy Framework is officially released!

The new V2 Strategy Framework 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.

We're introducing specialized templates for different trading paradigms, starting with Directional and Market Making strategies. These new strategy templates allow users to combine different composable components:

Watch this video for a preview:

Under Active Development

Dashboard is slated for incorporation into official Hummingbot releases before end of this year, but it is still under active development and new features and improvements are being added continuously. We highly encourage user feedback at this stage; feel free to share your thoughts and suggestions on Discord or Github. If you're excited to explore its capabilities, check out the beta.

Additions to Dashboard in the past month include:

We are excited to announce that Hummingbot is now available as a Python library, enabling more flexible usage and customization for developers!

To try it out, install the library into your Python environment with:

After installation is complete, enter your Python shell and run these commands to fetch historical OHLVC candles for BTC-USDT on Binance Futures for the past 30 days into a candles_test.csv file:

This upgrade not only brings in the latest features and bug fixes from Cython:

Modified the environment.yml dependencies to upgrade Cython to the latest 3.0 version (to move out from the alpha version the project is currently depending on).

Upgrading to the latest version allow Hummingbot to include all latest bugfixes. It will also allow the community to add the new functionality included in Cython 3.0 to generate a compiled Cythonized version of a pure Python module by just adding some Cython decorators to classes/functions.

Thanks to aarmoa for this contribution! 🙏

Kujira is a layer 1 ecosystem built on cosmos, blockchain known for its interoperability. Kujira Fin, is a decentralized order book exchange. It uses BOW as the market maker for liquidity. They claim no risk of impermanent loss with low gas fees and maker/taker fees.

See Kujira for the chain docs and Kujira Fin for the exchange connector docs.

Pull Requests: #6399, #138

Snapshot Proposal: https://snapshot.org/#/hbot-prp.eth/proposal/0x7dbd4a6f3cc7460ca6f56415a57b9727ca7a9227be625efdc4e71dee3d0d0781

Thanks to funttastic and yourtrading-ai for this contribution! 🙏

Launched in 2019, WOO X is a trading platform featuring deep liquidity, low trading costs and powerful tools & analytics. Some of you may also know us from our decentralized swap product WOOFi, which is one of the most-used cross-chain swaps with over half a million unique monthly active wallets.

Snapshot Proposal: https://snapshot.org/#/hbot-prp.eth/proposal/0x46c15f8b9cbbd97ebc8b83340bd748d5f68e84082d24383b91abdc3d8b9168c6

Thanks to waterquarks for this contribution! 🙏

This update introduces the CoinCap rate source to the rate oracle, offering an alternative to CoinGecko with price streaming capabilities.

Users can obtain an API key here.

Thanks to CoinAlpha for this contribution! 🙏

Examples:

Example 1 (unknown):

docker pull hummingbot/hummingbot:latest

Example 2 (unknown):

pip install hummingbot

Example 3 (python):

import asyncio

from hummingbot.data_feed.candles_feed.candles_factory import CandlesFactory, CandlesConfig

async def collect_candles():
    candles = CandlesFactory.get_candle(CandlesConfig(connector="binance_perpetual", trading_pair="BTC-USDT", interval="3m", max_records=1440))
    candles.start()
    while not candles.is_ready:
        print(f"Candles not ready yet! Missing {candles._candles.maxlen - len(candles._candles)}")
        await asyncio.sleep(1)
    df = candles.candles_df
    df.to_csv("candles_test.csv", index=False)

asyncio.run(collect_candles())