---

Hummingbot is an open-source project that integrates cryptocurrency trading on both centralized exchanges and decentralized protocols. It allows users to run a client that executes customized, automated trading strategies for cryptocurrencies.

We created hummingbot to promote decentralized market-making: enabling members of the community to contribute to the liquidity and trading efficiency in cryptocurrency markets. For more detailed information, please visit the Hummingbot website and read the Hummingbot whitepaper.

• Join our community
• Documentation
• Follow us on Twitter
• Read our blog

Supported cryptocurrency exchanges

logo	id	name	ver	doc
	binance	Binance	*	API
	radar_relay	Radar Relay	2	API
	ddex	DDEX	3	API
	coinbase_pro	Coinbase Pro	*	API

Community contributed exchanges

logo	id	name	ver	doc
	bamboo_relay	Bamboo Relay	*	API

Currently available strategies

Strategy	Test
Pure market making
Cross exchange market making
Arbitrage
Discovery

Project Breakdown

hummingbot/
    client/                         # CLI related files
    core/ 
        cpp/                        # high performance data types written in .cpp
        data_type/                  # key data 
        event/                      # defined events and event-tracking related files
        utils/                      # helper functions and bot plugins      
    data_feed/                      # price feeds such as CoinCap
    market/                         # connectors to individual exchanges
        <market_name>/
            *market                 # handles trade execution (buy/sell/cancel)
            *data_source            # initializes and maintains a websocket connect
            *order_book             # takes order book data and formats it with a standard API                 
            *order_book_tracker     # maintains a copy of the market's real-time order book    
            *active_order_tracker   # for DEXes that require keeping track of                  
            *user_stream_tracker    # tracker that process data specific to the user running the bot
    notifier/                       # connectors to services that sends notifications such as Telegram
    strategy/                       # high level strategies that works with every market
    wallet/                         # files that reads from and submit transactions to blockchains
        ethereum/                   # files that interact with the ethereum blockchain

Install Hummingbot

See Installation Guide.

Learn more

See FAQs.

Contributing

We welcome code contributions (via pull requests) as well as bug reports and feature requests through github issues.

When doing so, please review the contributing guidelines.

Contact

Hummingbot was created and is maintained by CoinAlpha.

You can contact us at [email protected] or join our Discord server.

For business inquiries, please contact us at [email protected].