🐦 Project Hummingbird

Automated Crypto Trading

A comprehensive setup for Hummingbot — the open-source framework powering $34B+ in trading volume, integrated with Clawdbot for intelligent automation.

$34B+
Trading Volume
140+
Exchanges
10K+
GitHub Stars

System Status

ONLINE

Hummingbot Container

hummingbot/hummingbot:latest

PAPER MODE

Trading Mode

Simulated trading for strategy testing

PENDING

Exchange Connections

0 exchanges connected

Implementation Roadmap

Phase 1 ✓
Environment Setup
Hummingbot installed via Docker and running on the server.
  • Install Docker & Docker Compose
  • Clone Hummingbot repository
  • Run docker-compose up -d
  • Container running: hummingbot/hummingbot:latest
Phase 2
Exchange Connections
Connect to target exchanges and configure API credentials securely.
  • Select exchanges (Binance, Gate.io, KuCoin)
  • Generate API keys with trading permissions
  • Store credentials in AWS Parameter Store
  • Configure connectors in Hummingbot
Phase 3
Strategy Configuration
Set up initial trading strategies starting with low-risk paper trading.
  • Configure paper trading mode
  • Set up cross-exchange arbitrage strategy
  • Define risk parameters and position limits
  • Backtest with historical data
Phase 4
Clawdbot Integration
Wire up monitoring, alerts, and intelligent oversight.
  • Create monitoring cron job for P&L tracking
  • Set up Discord alerts for trades
  • Build dashboard for real-time status
  • Configure emergency stop triggers
Phase 5
Live Trading
Graduate from paper trading to live execution with small positions.
  • Review paper trading performance
  • Fund exchange accounts (small amounts)
  • Enable live trading with strict limits
  • Monitor and iterate

Trading Strategies

Low Risk

Cross-Exchange Arbitrage

Profit from price discrepancies between exchanges. Buy low on one, sell high on another. Requires accounts on multiple exchanges with pre-funded balances.

strategy: cross_exchange_arbitrage
min_profitability: 0.3%
Medium Risk

Market Making

Provide liquidity by placing orders on both sides of the order book. Earn the spread while managing inventory risk.

strategy: pure_market_making
bid_spread: 0.1%
ask_spread: 0.1%
Advanced

AMM Arbitrage

Exploit price differences between centralized exchanges and DEX AMMs like Uniswap. Requires Gateway middleware for DEX connectivity.

strategy: amm_arb
connector_1: binance
connector_2: uniswap_ethereum

Tech Stack

🐍 Python 3.10+
🐳 Docker
🐦 Hummingbot
🦎 Clawdbot
☁️ AWS (Secrets)
🌐 Cloudflare Pages

Supported Exchanges

🔶 Binance
🟢 KuCoin
🔵 Gate.io
⚫ OKX
🟣 Hyperliquid
🦄 Uniswap

Clawdbot Integration

📊

Real-Time Monitoring

Clawdbot polls Hummingbot status via CLI, tracks P&L, and updates this dashboard automatically.

🔔

Trade Alerts

Get notified on Discord for significant trades, arbitrage opportunities found, and position changes.

🛑

Emergency Controls

Clawdbot can pause or stop trading instantly if drawdown limits are hit or anomalies detected.

📈

Strategy Tuning

Adjust parameters like spread, position size, and profitability thresholds through chat commands.

⚠️

Risk Disclosure

Automated trading carries significant risk. You can lose money — even with well-designed strategies. This project starts with paper trading and small positions. Never trade more than you can afford to lose. Past performance (including Hummingbot's reported volumes) does not guarantee future results.

Quick Start Commands

Check Status

docker ps | grep hummingbot

View Logs

docker logs hummingbot --tail 50

Attach to Bot

docker attach hummingbot
# Ctrl+P, Ctrl+Q to detach

Restart Bot

cd ~/hummingbot && docker-compose restart