Hummingbot

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	PERP 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
	Defira	AMM DEX
	Dexalot	CLOB DEX
	HitBTC	SPOT CEX
	Huobi	SPOT CEX
	Injective	CLOB DEX
	Kraken	SPOT CEX
	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
	Phemex Perpetual	PERP CEX
	Polkadex	SPOT DEX
	Ref Finance	SPOT DEX
	Sushiswap	AMM DEX
	Tinyman	SPOT DEX
	VVS Finance	AMM DEX
	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
• Dashboard: Hummingbot Dashboard community project

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.