Hummingbot is an open source framework that helps you build automated trading strategies, or bots that run on cryptocurrency exchanges.
This code is free and publicly available under the Apache 2.0 open source license!
Why Hummingbot?
- Both CEX and DEX connectors: Hummingbot supports connectors to centralized exchanges like Binance and KuCoin, as well as decentralized exchanges like Uniswap and PancakeSwap on various blockchains (Ethereum, BNB Chain, etc).
- Community-contributed strategies: The Hummingbot community has added many customizable templates for market making, arbitrage, and other algo trading strategies.
- Secure local client: Hummingbot is a local client software that you install and run on your own devices or cloud virtual machines. It encrypts your API keys and private keys and never exposes them to any third parties.
- Community modules and events: Hummingbot is driven by a global community of quant traders and developers. Check out community-maintained modules like Orchestration, join our bi-weekly developer calls, and learn how to build custom strategies using Hummingbot by taking Botcamp!
Help us democratize high-frequency trading and make powerful trading algorithms accessible to everyone in the world!
Quick Links
- Docs: Check out the official Hummingbot documentation
- Installation: Install Hummingbot on various platforms
- FAQs: Answers to all your burning questions
- Botcamp: Learn how build your own custom HFT strategy in Hummingbot with our hands-on bootcamp!
- HBOT: Learn how you can decide how this codebase evolves by voting with HBOT tokens
Community
- Newsletter: Get our monthly newletter whenever we ship a new release
- Discord: The main gathering spot for the global Hummingbot community
- YouTube: Videos that teach you how to get the most of of Hummingbot
- Twitter: Get the latest announcements about Hummingbot
- Snapshot: Participate in monthly polls that decide which components should be prioritized and included
Exchange Connectors
Hummingbot connectors standardize trading logic and order types across different exchange types. Currently, we support the following exchange types:
- SPOT: Connectors to central limit order book (CLOB) exchanges that trade spot markets
- PERP: Connectors to central limit order book (CLOB) exchanges that trade perpetual swap markets
- AMM: Connectors to decentralized exchanges that use the Automatic Market Maker (AMM) methodology
Exchanges may be centralized (CEX), or decentralized (DEX), in which case user assets are stored on the blockchain and trading is performed via wallet addresses.
| Tier | Exchange | Type | Signup code |
|---|---|---|---|
 |
Binance | SPOT CEX | FQQNNGCD |
|
Binance Futures | PERP CEX | hummingbot |
|
Uniswap | AMM DEX | |
 |
KuCoin | SPOT CEX | 272KvRf |
|
KuCoin Perpetual | PERP CEX | 272KvRf |
|
Gate.io | SPOT CEX | 5868285 |
|
Gate.io Perpetual | PERP CEX | 5868285 |
|
AscendEx | SPOT CEX | UEIXNXKW |
|
Quickswap | AMM DEX | |
|
TraderJoe | AMM DEX | |
|
dYdX | PERP DEX | |
 |
AltMarkets | SPOT CEX | |
|
BTC-Markets | SPOT CEX | |
|
Binance US | SPOT CEX | |
|
BitGet | PERP CEX | |
|
Bit.com | SPOT CEX | |
|
BitMart | SPOT CEX | |
|
Bitfinex | SPOT CEX | |
|
Bitmex | SPOT CEX | |
|
Bitmex (perp | SPOT CEX | |
|
Bittrex | SPOT CEX | |
|
Bybit | SPOT CEX | |
|
Bybit (perp) | PERP CEX | |
|
Coinbase | SPOT CEX | |
|
Crypto.com | SPOT CEX | |
|
DeFi Kingdoms | AMM DEX | |
|
Defira | AMM DEX | |
|
Dexalot | CLOB DEX | |
|
HitBTC | SPOT CEX | |
|
Hotbit | SPOT CEX | |
|
Huobi | SPOT CEX | |
|
Injective | CLOB DEX | |
|
Kraken | SPOT CEX | |
|
LBank | SPOT DEX | |
|
Loopring | SPOT DEX | |
|
MEXC | SPOT CEX | |
|
Mad Meerkat | SPOT DEX | |
|
NDAX | SPOT DEX | |
|
OKX | SPOT CEX | |
|
OpenOcean | AMM DEX | |
|
Pancakeswap | AMM DEX | |
|
Pangolin | AMM DEX | |
|
Perpetual Protocol | PERP DEX | |
|
ProBit | SPOT CEX | |
|
Ref Finance | SPOT DEX | |
|
Sushiswap | AMM DEX | |
|
VVS Finance | AMM DEX | |
|
WhiteBit | SPOT CEX | |
|
XSWAP | AMM DEX |
Quarterly Polls allow the Hummingbot community to vote using HBOT tokens to decide which exchanges should be certified GOLD or SILVER, which means that they are maintained and continually improved by Hummingbot Foundation. In addition, the codebase includes BRONZE exchange connectors that are maintained by community members. See the Hummingbot documentation for all exchanges supported.
Strategies and Scripts
We provide customizable strategy templates for core trading strategies that users can configure, extend, and run. Hummingbot Foundation maintains three CORE strategies:
- Pure Market Making: Our original single-pair market making strategy
- Cross Exchange Market Making: Provide liquidity while hedging filled orders on another exchange
- AMM Arbitrage: Exploits price differences between AMM and SPOT exchanges
CORE strategies are selected via HBOT voting through quarterly Polls. In addition, the codebase includes COMMUNITY strategies that are maintained by individuals or firms in the community. See the Hummingbot documentation for all strategies supported.
Scripts
Scripts are a newer, lighter way to build Hummingbot strategies in Python, which let you modify the script's code and re-run it to apply the changes without exiting the Hummingbot interface or re-compiling the code.
See the Scripts section in the documentation for more info, or check out the /scripts folder for all Script examples included in the codebase.
Other Hummingbot Repos
- Hummingbot Site: Official documentation for Hummingbot - we welcome contributions here too!
- Hummingbot Project Management: Agendas and recordings of regular Hummingbot developer and community calls
- Awesome Hummingbot: All the Hummingbot links
- Hummingbot StreamLit Apps: Hummingbot-related StreamLit data apps and dashboards
- Community Tools: Community contributed resources related to Hummingbot
- Brokers: Different brokers that can be used to communicate with multiple instances of Hummingbot
- Deploy Examples: Deploy Hummingbot in various configurations with Docker
- Remote Client: A remote client for Hummingbot in Python
Contributions
Hummingbot belongs to its community, so we welcome contributions! Please review these guidelines first.
To have your pull request merged into the codebase, submit a Pull Request Proposal on our Snapshot. Note that you will need 1 HBOT in your Ethereum wallet to submit a Pull Request Proposal. See HBOT for more information.
Legal
- License: Hummingbot is licensed under Apache 2.0.
- Data collection: read important information regarding Hummingbot Data Collection.