hummingbot

---

Hummingbot is an open source framework that helps you design and deploy automated trading strategies, or bots, that can run on many centralized or decentralized exchange. Over the past year, Hummingbot users have generated over $34 billion in trading volume across 140+ unique trading venues.

The Hummingbot codebase is free and publicly available under the Apache 2.0 open source license. Our mission is to democratize high-frequency trading by creating a global community of algorithmic traders and developers that share knowledge and contribute to the codebase.

Quick Links

• Website and Docs: Official Hummingbot website and documentation
• Installation: Install Hummingbot on various platforms
• 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
• Reported Volumes: Reported trading volumes across all Hummingbot instances
• Newsletter: Get our newsletter whenever we ship a new release

Exchange Connectors

Hummingbot connectors standardize REST and WebSocket API interfaces to different types of exchanges, enabling you to build sophisticated trading strategies that can be deployed across many exchanges with minimal changes. We classify exchanges into the following categories:

• CEX: Centralized exchanges that take custody of your funds. Use API keys to connect with Hummingbot.
• DEX: Decentralized, non-custodial exchanges that operate on a blockchain. Use wallet keys to connect with Hummingbot.

In addition, connectors differ based on the type of market supported:

• CLOB Spot: Connectors to spot markets on central limit order book (CLOB) exchanges
• CLOB Perp: Connectors to perpetual futures markets on CLOB exchanges
• AMM: Connectors to spot markets on Automatic Market Maker (AMM) decentralized exchanges

Exchange Sponsors

We are grateful for the following exchanges who support the development and maintenance of Hummingbot via broker partnerships and sponsorships.

Connector ID	Exchange	CEX/DEX	Market Type	Docs	Discount
binance	Binance	CEX	CLOB Spot	Docs
binance_perpetual	Binance	CEX	CLOB Perp	Docs
gate_io	Gate.io	CEX	CLOB Spot	Docs
gate_io_perpetual	Gate.io	CEX	CLOB Perp	Docs
htx	HTX (Huobi)	CEX	CLOB Spot	Docs
kucoin	KuCoin	CEX	CLOB Spot	Docs
kucoin_perpetual	KuCoin	CEX	CLOB Perp	Docs
okx	OKX	CEX	CLOB Spot	Docs
okx_perpetual	OKX	CEX	CLOB Perp	Docs
dydx_v4_perpetual	dYdX	DEX	CLOB Perp	Docs	-
hyperliquid_perpetual	Hyperliquid	DEX	CLOB Perp	Docs	-
xrpl	XRP Ledger	DEX	CLOB Spot	Docs	-

Other Exchange Connectors

Currently, the master branch of Hummingbot also includes the following exchange connectors, which are maintained and updated through the Hummingbot Foundation governance process. See Governance for more information.

Connector ID	Exchange	CEX/DEX	Type	Docs	Discount
ascend_ex	AscendEx	CEX	CLOB Spot	Docs	-
balancer	Balancer	DEX	AMM	Docs	-
bitfinex	Bitfinex	CEX	CLOB Spot	Docs	-
bitget_perpetual	Bitget	CEX	CLOB Perp	Docs	-
bitmart	BitMart	CEX	CLOB Spot	Docs	-
bitrue	Bitrue	CEX	CLOB Spot	Docs	-
bitstamp	Bitstamp	CEX	CLOB Spot	Docs	-
btc_markets	BTC Markets	CEX	CLOB Spot	Docs	-
bybit	Bybit	CEX	CLOB Spot	Docs	-
bybit_perpetual	Bybit	CEX	CLOB Perp	Docs	-
carbon	Carbon	DEX	AMM	Docs	-
coinbase_advanced_trade	Coinbase	CEX	CLOB Spot	Docs	-
cube	Cube	CEX	CLOB Spot	Docs	-
curve	Curve	DEX	AMM	Docs	-
dexalot	Dexalot	DEX	CLOB Spot	Docs	-
hashkey	HashKey	CEX	CLOB Spot	Docs	-
hashkey_perpetual	HashKey	CEX	CLOB Perp	Docs	-
injective_v2	Injective Helix	DEX	CLOB Spot	Docs	-
injective_v2_perpetual	Injective Helix	DEX	CLOB Perp	Docs	-
kraken	Kraken	CEX	CLOB Spot	Docs	-
mad_meerkat	Mad Meerkat	DEX	AMM	Docs	-
mexc	MEXC	CEX	CLOB Spot	Docs	-
ndax	NDAX	CEX	CLOB Spot	Docs	-
openocean	OpenOcean	DEX	AMM	Docs	-
pancakeswap	PancakeSwap	DEX	AMM	Docs	-
pangolin	Pangolin	CEX	DEX	Docs	-
polkadex	Polkadex	DEX	CLOB Spot	Docs	-
quickswap	QuickSwap	DEX	AMM	Docs	-
sushiswap	SushiSwap	DEX	AMM	Docs	-
tinyman	Tinyman	DEX	AMM	Docs	-
traderjoe	Trader Joe	DEX	AMM	Docs	-
uniswap	Uniswap	DEX	AMM	Docs	-
vertex	Vertex	DEX	CLOB Spot	Docs	-
vvs	VVS	DEX	AMM	Docs	-
xsswap	XSSwap	DEX	AMM	Docs	-

Other Hummingbot Repos

• Deploy: Deploy Hummingbot in various configurations with Docker
• Dashboard: Web app that help you create, backtest, deploy, and manage Hummingbot instances
• Quants Lab: Juypter notebooks that enable you to fetch data and perform research using Hummingbot
• Gateway: Typescript based API client for DEX connectors
• Hummingbot Site: Official documentation for Hummingbot - we welcome contributions here too!

Contributions

The Hummingbot architecture features modular components that can be maintained and extended by individual community members.

We welcome contributions from the community! Please review these guidelines before submitting a pull request.

To have your exchange connector or other pull request merged into the codebase, please submit a New Connector Proposal or Pull Request Proposal, following these guidelines. Note that you will need some amount of HBOT tokens in your Ethereum wallet to submit a proposal.

Legal

• License: Hummingbot is open source and licensed under Apache 2.0.
• Data collection: See Reporting for information on anonymous data collection and reporting in Hummingbot.