Hummingbot Order Level Builder: Distributing Orders Across Price Levels
Article Hummingbot docs
Summary
This release note introduces Hummingbot’s Order Level Builder, a tool for defining how orders are spread across multiple price levels. It lists linear, arithmetic, geometric, and logarithmic distributions, with configurable parameters such as the starting and ending spread and the number of levels. These choices let a trader shape order spacing to fit a strategy’s intended placement pattern; the note does not explain the formulas or compare their behavior in different market conditions.
The release also announces V2 strategy documentation, a Curve decentralized exchange connector, and a Foxbit centralized exchange connector, alongside assorted updates and fixes. It provides no backtest, execution measurements, or trading results, so it serves primarily as a feature overview rather than evidence that a particular distribution improves performance. The release note does not specify order-level risk controls or how the distributions interact with inventory, fees, and changing liquidity; those details require the separate product documentation.
Key ideas
- The Order Level Builder creates order distributions across multiple price levels.
- Supported distribution types include linear, arithmetic, geometric, and logarithmic spacing.
- Traders can configure parameters such as start spread, end spread, and number of levels.
- The release note lists new Curve and Foxbit connectors and expanded V2 strategy documentation.
- The note provides no comparative performance evidence for the distribution methods.
Tags
Full text
# Hummingbot v1.22.0 Release Notes # Hummingbot v1.22.0 Release Notes *Released on November 27, 2023* ## Introduction We are thrilled to announce the release of Hummingbot version 1.22.0. This release adds an array of documentation improvements, including a dedicated **Academy** page tailored for new users and a comprehensive documentation for the new **V2 Strategies Framework**. Additionally, we're unveiling a new **Curve** DEX connector and reintroducing **Foxbit** to our lineup of CEX connectors. Alongside these updates, this release brings numerous bug fixes, ensuring enhanced performance and reliability for a seamless trading experience. | Repository | Description | GitHub Release | DockerHub Release | |------------|-------------|----------------|-------------------| | [Hummingbot](https://github.com/hummingbot/hummingbot) | Core Trading Engine | [`v1.22.0`](https://github.com/hummingbot/hummingbot/releases/tag/v1.22.0) | [`version-1.22.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-1.22.0) | | [Gateway](https://github.com/hummingbot/gateway) | DEX Connector Middleware | [`v1.22.0`](https://github.com/hummingbot/gateway/releases/tag/v1.22.0) | [`version-1.22.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-1.22.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 Nov 30th * **Time**: 4pm GMT / 10pm SIN / 10am EST / 7am PST * **Location**: [Hummingbot Discord](https://discord.gg/hummingbot) * **Event Link**: <https://discord.gg/gJVMFtes?event=1173954374301659257> 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/TTaL3g4l8uM" 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). ## New Academy section In [#247](https://github.com/hummingbot/hummingbot-site/pull/247), we have added **Hummingbot Academy**, a comprehensive learning hub designed for both new and experienced users. This section includes: - **Quickstart Guides**: Step-by-step tutorials for beginners to get up and running with Hummingbot. - **Strategy Tutorials**: In-depth explanations of various trading strategies and how to implement them using Hummingbot. - **User Interviews**: Tips and tricks from real users on optimizing trading strategies and managing risks. - **Community Posts**: A collection of resources, tips, and strategies shared by our vibrant community. Explore [Hummingbot Academy](../academy/index.md) to enhance your trading skills and knowledge! ## New V2 Strategy Documentation The **V2 Strategies Framework** documentation now includes comprehensive guides for each of the components below.  Dive into the documentation at [V2 Strategies](../strategies/v2-strategies/index.md) to explore the full potential of these new strategies! ## New CEX Connector: FoxBit Founded in 2014, [FoxBit](https://www.foxbit.com.br/) is a leading cryptocurrency exchange in Brazil, offering a user-friendly platform with advanced trading features. Renowned for its security and transparency, Foxbit provides a seamless experience for buying, selling, and storing a variety of cryptocurrencies. With a strong focus on customer support and education, Foxbit aims to empower users to navigate the digital currency space confidently. See [FoxBit](../exchanges/foxbit/index.md) for the exchange connector docs. **Pull Requests:** [#6588](https://github.com/hummingbot/hummingbot/pull/6588) **Snapshot Proposal:** <https://snapshot.org/#/hbot-ncp.eth/proposal/0x533acd5e246b94f8d823de0960122ed7f11ceed6f253c6a828abe71a55fcc7f4> **Thanks to [gabrielsilvafoxbit](https://github.com/gabrielsilvafoxbit) for this contribution! 🙏** ## New DEX Connector: Curve Launched in 2020, [Curve](https://curve.fi/) is a decentralized finance (DeFi) platform renowned for its low-slippage and low-fee liquidity provision on the Ethereum blockchain. Specializing in stablecoin trading, Curve leverages advanced algorithms to offer efficient and stable swaps. It's a popular choice among users looking to exchange stablecoins and wrapped assets with minimal price deviation. Curve also integrates with various DeFi protocols, enhancing liquidity and yield farming opportunities for its users. See Curve for the exchange connector docs. **Pull Requests:** [#215](https://github.com/hummingbot/gateway/pull/215) **Snapshot Proposal:** <https://snapshot.org/#/hbot-ip.eth/proposal/0x0f86d963fc90c972efb78f6ae56b2ae2b189c6d6c8ffa1470aa000251a1163cb> **Thanks to [vic-en](https://github.com/vic-en) for this contribution! 🙏** ## Order Level Builder In [#6615](https://github.com/hummingbot/hummingbot/pull/6615), we are excited to announce the integration of the `Order Level Builder` into Hummingbot. This new feature allows users to create and manage order distributions with enhanced precision and flexibility, catering to a wide range of trading strategies. The Order Level Builder introduces several distribution types, including `Linear`, `Arithmetic`, `Geometric`, and `Logarithmic`, each designed to meet different strategic needs. Users can now set parameters such as `start_spread`, `end_spread`, `n_levels`, and others depending on the chosen distribution type. This offers a tailored approach to order placement, allowing traders to optimize their strategies according to market conditions and personal preferences. For more information check the Order Levels documentation. ## Other Updates ### Hummingbot * [#6625](https://github.com/hummingbot/hummingbot/pull/6625) - Added support to multiple markets and market orders for Kujira **Thanks to [danilo-silva-funttastic](https://github.com/danilo-silva-funttastic) for this fix! 🙏** * [#6626](https://github.com/hummingbot/hummingbot/pull/6626) - Updated README.md with current list of connectors * [#6627](https://github.com/hummingbot/hummingbot/pull/6627) - Updated README.md with current list of connectors * [#6629](https://github.com/hummingbot/hummingbot/pull/6629) - Added a new `gateway balance` command that reports balances and allowances of connected wallets **Thanks to [isreallee82](https://github.com/isreallee82) for this fix! 🙏** * [#6639](https://github.com/hummingbot/hummingbot/pull/6639) - Added `.csv` to pattern to only filter those files * [#6640](https://github.com/hummingbot/hummingbot/pull/6640) - Fixed issue with [Kucoin Perpetual](../exchanges/kucoin/index.md) leverage **Thanks to [leastchaos](https://github.com/leastchaos) for this fix! 🙏** * [#6644](https://github.com/hummingbot/hummingbot/pull/6644) - Added DB table for position executors and refactored the logic of the executor handler to store the executors in the DB instead of the csv. * [#6649](https://github.com/hummingbot/hummingbot/pull/6649) - Removed Loopring * [#6651](https://github.com/hummingbot/hummingbot/pull/6651) - Updated connector status * [#6652](https://github.com/hummingbot/hummingbot/pull/6652) - Fixed Phemex Perpetual API endpoints **Thanks to [jtashiro](https://github.com/jtashiro) for this fix! 🙏** ### Gateway * [#218](https://github.com/hummingbot/gateway/pull/218) - Updated the code changing the references of the `Tendermin34Client` class in favor of the `Tendermint37Client` class **Thanks to [danilo-silva-funttastic](https://github.com/danilo-silva-funttastic) for this fix! 🙏** * [#223](https://github.com/hummingbot/gateway/pull/223) - Fixed some bugs and performed general maintenance on Tezos and Plenty connectors **Thanks to [OjusWiZard](https://github.com/OjusWiZard) for this fix! 🙏** * [#230](https://github.com/hummingbot/gateway/pull/230) - Removed Injective chain and exchange connectors
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.