Hummingbot 1.16: Trading Tools, Connectors, and Strategy Examples
Article Hummingbot docs
Summary
These release notes describe updates to Hummingbot, an open-source crypto trading platform. Trading-relevant changes include market-order support on selected exchange connectors, new exchange and blockchain integrations, and example scripts for equal-weight portfolio construction and spot–perpetual arbitrage. The arbitrage example opens a spot long and a perpetual short when its signal triggers, then closes both legs later; its stated profit premise is convergence between spot and perpetual prices. The notes also mention improved multi-timeframe candle downloading and a dashboard for monitoring strategies while they run.
The release information documents software capabilities and example designs, not evidence that any strategy is profitable. The dashboard is described as experimental, and the arbitrage description gives no signal specification, funding or fee analysis, slippage estimates, or backtest results. Connector support and execution behavior can vary by venue, and the notes advise users upgrading the client and Gateway to update both components and refresh Gateway configuration. These details make the release useful for understanding available infrastructure, while leaving strategy validation and operational risk to the user.
Key ideas
- The release adds market-order and maker-limit-order support to selected exchange connectors.
- A sample arbitrage script pairs a spot long with a perpetual short and exits both legs on a closing signal.
- A separate script demonstrates equal-weight allocation across a cryptocurrency portfolio.
- The new live strategy dashboard is presented as experimental and intended for feedback.
- The release notes provide no performance results or full signal and cost specifications for the strategy examples.
Tags
Full text
# Release Notes - Version 1.16.0
# Release Notes - Version 1.16.0
*Released on May 29, 2023*
We are very excited to ship the May 2023 release of Hummingbot (v1.16.0) today!
This release adds the first iteration of Hummingbot Dashboard, a powerful new way to visualize and analyze your strategies. It also greatly simplifies the Docker installation process, added market orders support to top exchange connectors, and introduces connectors to the Algorand blockchain, Phemex, and more!
!!! note "New trades DB columns"
This release adds new columns to the trades database stored for each strategy/script to support the new Hummingbot Dashboard. As a result, we recommend that if you are updating from an older version of Hummingbot and want to run an strategy created using that older version, you should back up and delete the associated `.sqlite` file related to that strategy located in the `/data` folder. Failure to do so may result in errors upon re-starting the strategy.
**Hummingbot**
* Github: [`v1.16.0`](https://github.com/hummingbot/hummingbot/releases/tag/v1.16.0)
* DockerHub: [`version-1.16.0`](https://hub.docker.com/r/hummingbot/hummingbot/tags?name=version-1.16.0)
**Hummingbot Gateway**
* Github: [`v1.16.0`](https://github.com/hummingbot/gateway/releases/tag/v1.16.0)
* DockerHub: [`version-1.16.0`](https://hub.docker.com/r/hummingbot/gateway/tags?name=version-1.16.0)
!!! note "Update Gateway"
Gateway users will also need to update Gateway to v1.16 after updating the Hummingbot client and then run the [gateway-setup](https://github.com/hummingbot/gateway/blob/main/gateway-setup.sh) script to regenerate your configs then re-run the `gateway connect ...` command again from within Hummingbot. Otherwise, you'll get an error message about `"Unhandled error in background task: 'chain_type'"` when running Gateway.
!!! tip "Multi-arch Docker"
With this release, Hummingbot now offers a multi-arch Docker image that supports both x86 and arm64 architectures. Users no longer need to download a separate Docker image for ARM builds.
**Deployment Repos**
* [`hummingbot/deploy-examples`](https://github.com/hummingbot/deploy-examples): Deploy Hummingbot in various configurations with Docker
* [`hummingbot/brokers`](https://github.com/hummingbot/brokers): MQTT-based broker that orchestrates multiple Hummingbot instances
* [`hummingbot/hbot-remote-client-py`](https://github.com/hummingbot/hbot-remote-client-py): A remote client for Hummingbot in Python
* **[NEW]** [`hummingbot/dashboard`](https://github.com/hummingbot/dashboard): Dashboards that helps you visualize and analyze your Hummingbot strategies
See below for what's new this month!
## Community Call Recaps
In the last Community Call, Mike discussed the highlights from the v1.15.0 release, the new Bounties initiative, & community member TheHolyRoger presented Phase 2 of the Orchestration Module:
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/LNLkPdlClbc" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
In the last How-To Call, Fede discussed how to use Hummingbot's Telegram integration in conjunction with custom scripts and deployments:
<iframe style="width:100%; min-height:400px;" src="https://www.youtube.com/embed/BJ6NuwpRkKo" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
Each month, we livestream two community calls on our [Discord](https://discord.gg/hummingbot) server:
* Community Call: monthly release highlights, governance discussions, and community demos
* How-To Call: in-depth demos and live coding of key Hummingbot features
Check out the [Hummingbot Events Calendar](https://lu.ma/u/hummingbot) for links to these monthly calls and other upcoming events.
## Hummingbot Dashboard
[](../assets/img/dashboard.png)
Formerly called Streamlit-Apps, the new [Hummingbot Dashboard](https://github.com/hummingbot/dashboard) lets you visualize and analyze a strategy, even as it's running in real-time.
This is an experimental new module that we are still prototyping, and we welcome the community to test out and provide feedback. We plan to make significant improvements to this dashboard in the next few releases.
## Installation Improvements
We have streamlined the installation process so that there is a single `environment.yml` file in the `setup` folder. In addition, the Hummingbot Docker image can now be built using a simple command for multiple architectures, making it more accessible across a range of systems, including `x86` and `ARM` architectures. These modifications are expected to enhance the overall user experience by simplifying the setup process and making Hummingbot more adaptable across a wide range of systems.
**Pull Request:** [#6229](https://github.com/hummingbot/hummingbot/pull/6229), [#6297](https://github.com/hummingbot/hummingbot/pull/6297)
## Market Orders Support
Following our [Technical Roadmap](https://hummingbot.org/blog/posts/hummingbot-2023-technical-roadmap/), we are expanding our connectors to support to include all order types offered by an exchange. In this release, we and community developers have added the integration of `market_order` and `limit_maker_order` types for the following exchanges:
* [Binance](../exchanges/binance/index.md)
* [Gate.io Perpetual](../exchanges/gate-io/index.md)
* [dydx](../exchanges/dydx.md)
**Pull Request:** [#6279](https://github.com/hummingbot/hummingbot/pull/6279), [#6305](https://github.com/hummingbot/hummingbot/pull/6305), [#6308](https://github.com/hummingbot/hummingbot/pull/6308)
## New Bounties Documentation
[Bounties](../bounties/index.md) offer a platform for those seeking development work on exchange connectors, strategies, bug fixes, and more to connect with skilled developers capable of building these solutions.
Check out our new guides for prospective Contributors and Sponsors:
* [Contributors](../bounties/contributors.md)
* [Sponsors](../exchanges/index.md)
## New Script Examples
This release added the following new [Script](../strategies/scripts/index.md) examples and improvements to existing ones:
- [1overN_portfolio](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/1overN_portfolio.py): This strategy aims to create a 1/N cryptocurrency portfolio, providing perfect diversification without parametrization and giving a reasonable baseline performance. **Thanks to Botcamp member Roland Kofler for this contribution! 🙏**
- [spot_perp_arb](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/spot_perp_arb.py): This script improves upon and addresses problems with the current spot perp arbitrage strategy. It is designed to simultaneously initiate a long position in the spot market and a short position in the perpetual market when the opening signal is triggered. These positions are then closed upon receiving the closing signal. The profit is generated from the corrective motion between the spot price and the perpetual price. **Thanks to Botcamp member [riven314](https://github.com/riven314) for this contribution! 🙏**
- [download_candles.py](https://github.com/hummingbot/hummingbot/blob/master/strategies/scripts/download_candles.py): This script was improved by incorporating the capacity to download data across various intervals, thereby allowing simultaneous access to multiple timeframes. **Pull Request:** [#6289](https://github.com/hummingbot/hummingbot/pull/6289)
## New Chain/DEX Connectors: Algorand/Tinyman
[Algorand](https://algorand.com/) a fully decentralized, secure, and scalable blockchain which provides a common platform for building products and services for a borderless economy. [Tinyman](https://tinyman.org) is a decentralized trading protocol which utilizes the fast and secure framework of the Algorand blockchain.
See Algorand for the chain docs and the Tinyman exchange connector docs.
**Pull Requests:** [#6277](https://github.com/hummingbot/hummingbot/pull/6277), [#0090](https://github.com/hummingbot/gateway/pull/0090)
**Snapshot Proposal:** https://snapshot.org/#/hbot-prp.eth/proposal/0x08a53dead66043ee8e8b0e65229a99b52be2e212a640e992eb72c9b4cd388701
**Thanks to [CoinAlpha](https://github.com/coinalpha) for this contribution! 🙏**
## New SPOT CEX Connector: Foxbit
[Foxbit](https://foxbit.com.br/) is a leading cryptocurrency trading platform recognized for its high liquidity in the Brazilian market. Founded in 2014, Foxbit is built on the principles of agility, transparency, and security, and is primarily geared towards Brazil-based users offering rapid Bitcoin trading with a 0% deposit fee against the Brazilian Real.
See the Foxbit connector documentation for more information.
**Pull Request:** [#6155](https://github.com/hummingbot/hummingbot/pull/6155)
**Snapshot Proposal:** https://snapshot.org/#/hbot-prp.eth/proposal/0x8bb5b1341970a59988e3bcf635e3576c48f0ca3a0d1d86b9463b8be0b44d00b8
**Thanks to [mfavareto-vitra](https://github.com/mfavareto-vitra) for this contribution! 🙏**
## New PERP CEX Connector: Phemex
[Phemex](https://phemex.com/trade) is a crypto derivatives trading exchange. Based in Singapore, it was launched in 2019 by former executives from Morgan Stanley. The project is rapidly gaining popularity due to low fees and deep liquidity, offering user-friendly charting and wallet interface, no-KYC, tight/fast execution spreads, as well as spot, contract, and margin trading.
See the Phemex Perpetual connector documentation for more information.
**Pull Request:** [#6218](https://github.com/hummingbot/hummingbot/pull/6218)
**Snapshot Proposal:** https://snapshot.org/#/hbot-prp.eth/proposal/0x6f4f16e7cebffe5258138b841963849d9a9d185e5afa714c5d769687c0ed8899
**Thanks to [CoinAlpha](https://github.com/coinalpha) for this contribution! 🙏**
## Other Updates
### Hummingbot
* [#5900](https://github.com/hummingbot/hummingbot/pull/5900) Fixed issues with [OKX](../exchanges/okx/index.md) API trade fills reported in [#5800](https://github.com/hummingbot/hummingbot/issues/5800) and [#5896](https://github.com/hummingbot/hummingbot/issues/5896) **Thanks to [huatahhhhh](https://github.com/huatahhhhh) for this fix! 🙏**
* [#6088](https://github.com/hummingbot/hummingbot/pull/6088) Added the value of the trade fee in quote asset for reporting purposes
* [#6095](https://github.com/hummingbot/hummingbot/pull/6095) Included impact of deducted fees in performance report balances **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#6187](https://github.com/hummingbot/hummingbot/pull/6187) Updated [Injective](../exchanges/injective.md) spot connector to match latest perp connector changes **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#6271](https://github.com/hummingbot/hummingbot/pull/6271) Deprecated the [Dexalot](../exchanges/dexalot.md) API key **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#6236](https://github.com/hummingbot/hummingbot/pull/6236) Fixed the issue where failure occurred in fetching trading fees when the number of trading symbols exceeded 10 on the [Kucoin](../exchanges/kucoin/index.md) exchange. **Thanks to [riven314](https://github.com/riven314) for this fix! 🙏**
* [#6283](https://github.com/hummingbot/hummingbot/pull/6283) Added [Injective Perpetual](../exchanges/injective.md) rate limits **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#6284](https://github.com/hummingbot/hummingbot/pull/6284) Fixed issue where [Gate.io](../exchanges/gate-io/index.md) and [Kucoin Perpetual](../exchanges/kucoin/index.md) were showing the incorrect orderbook amount **Thanks to [yancong001](https://github.com/yancong001) for this fix! 🙏**
* [#6285](https://github.com/hummingbot/hummingbot/pull/6285) Fixed issue where Phemex funding payments were not reported **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#6291](https://github.com/hummingbot/hummingbot/pull/6291) Fixed issue reported in [#6055](https://github.com/hummingbot/hummingbot/issues/6055) where XEMM was crashing when a small amount maker trade happens **Thanks to [mfavareto-vitra](https://github.com/mfavareto-vitra) for this fix! 🙏**
* [#6296](https://github.com/hummingbot/hummingbot/pull/6296) Removed legacy Solana and Serum DEX connector code
* [#6300](https://github.com/hummingbot/hummingbot/pull/6300) Removed unused Gateway Docker code / commands
* [#6312](https://github.com/hummingbot/hummingbot/pull/6312) Updated connector status for Foxbit and Phemex Perpetual
* [#6313](https://github.com/hummingbot/hummingbot/pull/6313) Updated Gateway connector list
### Gateway
* [#0092](https://github.com/hummingbot/gateway/pull/0092) Updated [Injective](../exchanges/injective.md) dependencies and removed deprecated code **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#0098](https://github.com/hummingbot/gateway/pull/0098) Deprecated the [Dexalot](../exchanges/dexalot.md) API key **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#0099](https://github.com/hummingbot/gateway/pull/0099) Updated the BNB tokenlist with data from the tokenlist used by [Pancakeswap](../exchanges/gateway/pancakeswap.md) **Thanks to [CoinAlpha](https://github.com/coinalpha) for this fix! 🙏**
* [#0105](https://github.com/hummingbot/gateway/pull/0105) Refactored the connector statuses and adds a `chainType` field to the connector endpoint responses **Thanks to [CoinAlpha](https://github.com/coinalpha) 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.