/hummingbot

Hummingbot: a client for crypto market making

Primary LanguagePythonApache License 2.0Apache-2.0

Hummingbot


License Twitter Youtube Discord

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
Crypto.com SPOT CEX
DeFi Kingdoms AMM DEX
Defira AMM DEX
Dexalot CLOB DEX
Foxbit SPOT CEX
HitBTC 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
Phemex Perpetual PERP DEX
Polkadex SPOT DEX
ProBit SPOT CEX
Ref Finance SPOT DEX
Sushiswap AMM DEX
Tinyman SPOT DEX
VVS Finance AMM DEX
WhiteBit SPOT CEX
XSWAP AMM DEX
Zigzag SPOT 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:

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

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