Skip to content

Hummingbot v1.25.0 Release Notes

Released on February 26, 2024

Introduction

We're thrilled to unveil Hummingbot version 1.25.0! This release features new Connector Guides for Binance, Vega, Hyperliquid, and Polkadex, which make it easy for users to get started running bots on these exchanges with step-by-step instructions that show users how to generate credentials and use them with Hummingbot. Furthermore, we are excited to announce big improvements to the Discord Support Program, which rewards users for supporting other users on Discord by answering their questions. In addition, this release introduces the new Carbon DEX connector, adds Candles support for OKX Perpetual and Kraken, and greatly improves the XRP Ledger connector.

Last but not least, we are in the middle of a huge refactor to the V2 Strategies Framework and added two new sample strategies in this release. When this overhaul is complete, the V2 framework will be more intuitive and flexible for strategy development, paving the way for advanced trading strategies and customization.

Repository Description GitHub Release DockerHub Release
Hummingbot Core Trading Engine v1.25.0 version-1.25.0
Gateway DEX Connector Middleware v1.25.0 version-1.25.0

How to Update

Docker

Clone the latest 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 to learn about the new features in this release and other Hummingbot news:

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

For more community events, check out the Hummingbot Calendar.

Connector Guides

We are excited to introduce 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.

Binance

The Binance guide helps users set up and use Hummingbot with the world's largest crypto exchange by trading volume. It includes step-by-step instructions for generating API keys on Binance, ensuring account security through two-factor authentication, and adding these keys to Hummingbot.

Hyperliquid

The Hyperliquid guide provides instructions for using Hummingbot with Hyperliquid Vaults, where traders can deposit funds to be used by an automated strategy and earn a share of the profits. It explains how Vaults work, covers creating a Vault as a leader who operates the trading strategy, and depositing in Vaults as a depositor to passively earn returns. The guide then shows how to connect Hummingbot to Hyperliquid using a Vault address, allowing depositors to share in the performance and profits of the bot's trading strategies.

Vega

The Vega guide covers setting up a Vega wallet using the Metamask Snaps, funding it with tokens, installing Hummingbot, and connecting the wallet by entering your Vega party ID and seed phrase when prompted. The guide also provides trading pair formatting examples, troubleshooting for common issues like failed orders, and additional resources like links to Vega's documentation.

Polkadex

The Polkadex guide walks through setting up a Polkadex wallet, funding your trading account, and connecting it to Hummingbot to enable trading. It covers installing the Polkadex wallet browser extension, registering accounts, transferring tokens for trading, importing your trading account, and integrating it with Hummingbot by adding your seed phrase.

See Tag: Connector Guides for a full list of the current guides. HBOT holders can propose Bounties to fund the creation of additional guides by community contributors.

New Bounties Process

Hummingbot's bounty system lets sponsors tap into the thousands of quant traders and developers globally who run Hummingbot.

In this release we've revamped the documentation for the Bounties program to make it a lot easier for both Contributors and Sponsors to follow the steps needed to sponsor or contribute to a bounty. See Lifecycle of a Bounty.

Also, see the new Bounty Pricing Guidance page as a guideline to make it easier for both developers and sponsors to agree on a price for external bounties.

Discord Support Program Improvements

Hummingbot is a community of algorithmic traders and developers that help each other on Discord. We're excited to announce the following changes to the Discord Support Program:

  • Public Leaderboard
  • New Discord Roles
  • Increased Weekly Payout amount
  • Adjusted Reward Percentages
  • Revised Point System

For more information, including how to sign up, please see this blog post!

Improvements to V2 Strategies

This release starts a comprehensive refactor of the V2 Strategies framework, building on the foundation laid by the introduction of initial components last year. While this new framework has significantly enhanced Hummingbot's capabilities, the initial design made it challenging for users to extend and customize. See the #6844 for the ongoing pull request, which will be merged into the development branch shortly.

In addition, aside from the refactor, we've also added a couple new sample strategies in this release:

The DMan-V5 strategy strategy utilizes the MACD indicator to generate buy or sell signals, then applies a Dollar Cost Averaging approach to execute trades. It dynamically adjusts order amounts and spreads based on geometric distributions and manages executor actions based on the strategy's rules and market conditions. It includes mechanisms for taking profit, stopping losses, and employing a trailing stop to optimize trade outcomes.

The DMan-V6 strategy focuses on executing trades using the new DCAExecutor, which uses the Dollar Cost Average (DCA) approach to place orders at different price levels and conditions based on the strategy's configuration. The strategy dynamically adjusts its actions based on market conditions, the status of existing orders, and predefined settings for managing trades. This includes leveraging technical indicators, order distribution strategies, and risk management tools like stop loss and take profit parameters.

Pull Request: #6816

New DEX Connector: Carbon

Carbon is a decentralized trading protocol that enables users to execute advanced on-chain trading strategies in a non-custodial and fully on-chain manner. It offers features like automated limit orders, custom price range adjustments, and the ability to create "recurring strategies" for buying low and selling high within specified price ranges.

For more information, refer to the Carbon connector docs.

Pull Request: #256

Snapshot Proposal: NCP-9

Thanks to tiagofilipenunes for this contribution! 🙏

Other Updates

Hummingbot

  • #6791 - Added OKX Perpetuals candles feed Thanks to tomasgaudino for this fix! 🙏
  • #6796 - Renamed Huobi to HTX Thanks to blagodar1 for this fix! 🙏
  • #6811 - Updated Injective low level API components Thanks to aarmoa for this fix! 🙏
  • #6817 - Added Kraken spot candles feed Thanks to yancong001 for this fix! 🙏
  • #6827 - Added XRPL improvements for February Thanks to mlguys for this fix! 🙏
  • #6832 - Added option to switch to Hyperliquid vault for trading Thanks to yancong001 for this fix! 🙏
  • #6833 - Removed Bitmex and Woo X connectors as per Epoch 7 results
  • #6855 - Increased the update interval for XRPL and got Rate Oracle to work with not supported pairs Thanks to mlguys for this fix! 🙏

Gateway

  • #278 - Added XRPL improvements for February Thanks to mlguys for this fix! 🙏
  • #282 - Added retry and set submittx to submit and wait Thanks to mlguys for this fix! 🙏