Hummingbot 2026: 50개 이상 거래소 커넥터를 지원하는 오픈소스 암호화폐 트레이딩 봇 — 설치 및 전략 가이드

# Hummingbot 파일 디렉터리 생성
mkdir -p hummingbot_files/hummingbot_conf
mkdir -p hummingbot_files/hummingbot_logs
mkdir -p hummingbot_files/hummingbot_data

# 최신 Docker 이미지 가져오기
docker pull hummingbot/hummingbot:latest

# 대화형 모드로 Hummingbot 실행
docker run -it --name hummingbot \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_conf,destination=/conf" \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_logs,destination=/logs" \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_data,destination=/data" \
  hummingbot/hummingbot:latest

# Hummingbot CLI 낶에서
>>> connect binance

# API 키 입력
Enter your Binance API key >>> YOUR_API_KEY

# API 시크릿 입력
Enter your Binance API secret >>> YOUR_API_SECRET

# 연결 확인
>>> balance

# 새 전략 설정 생성
>>> create

# 전략 선택
What is your market making strategy? (pure_market_making/cross_exchange_market_making/arbitrage) >>> pure_market_making

# 거래 페어 선택
Enter the token trading pair you would like to trade on binance (e.g., BTC-USDT) >>> BTC-USDT

# 매수/매도 스프레드 설정 (0.5%)
What is the bid spread? (Enter 0.01 for 1%) >>> 0.005
What is the ask spread? (Enter 0.01 for 1%) >>> 0.005

# 주문 갱신 시간 설정
How often do you want to cancel and replace orders (in seconds)? >>> 30

# 주문 수량 설정
What is the amount of BTC per order? >>> 0.001

# 설정 확인
>>> config

# 전략 시작
>>> start

# Hummingbot을 종료하되 컨테이너는 계속 실행
Ctrl+P then Ctrl+Q

# 또는 처음부터 분리 모드로 시작
docker run -d --name hummingbot \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_conf,destination=/conf" \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_logs,destination=/logs" \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_data,destination=/data" \
  hummingbot/hummingbot:latest

# 상태 확인을 위해 연결
docker attach hummingbot
# 다시 분리하려면 Ctrl+P, Ctrl+Q

# conf/connectors/binance.yml
connector: binance
api_key: ${BINANCE_API_KEY}
api_secret: ${BINANCE_API_SECRET}
rate_limit: adaptive
timeout: 10
use_futures: false

>>> connect coinbase_advanced_trade
Enter your Coinbase API key (UUID format) >>> xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Enter your Coinbase API secret >>> YOUR_PRIVATE_KEY

# Gateway 가져오기 및 실행
docker pull hummingbot/gateway:latest

docker run -d --name gateway \
  -p 15888:15888 \
  --env GATEWAY_PASSPHRASE=your_secure_passphrase \
  hummingbot/gateway:latest

# Hummingbot에서 Gateway에 연결
>>> gateway connect uniswap_ethereum_mainnet

# 이더리움 메인넷의 Uniswap용 Gateway 설정
networks:
  ethereum:
    rpc_url: https://mainnet.infura.io/v3/YOUR_INFURA_KEY
    chain_id: 1
    token_list_type: FILE
    token_list_source: /home/gateway/conf/lists/ethereum_token_list.json

connectors:
  uniswap:
    contract_addresses:
      v3: 0xE592427A0AEce92De3Edee1F18E0157C05861564

# conf/telegram.yml
telegram_enabled: true
telegram_token: "YOUR_BOT_TOKEN"
telegram_chat_id: "YOUR_CHAT_ID"
notify_events:
  - order_filled
  - trade_completed
  - strategy_error

# SQLite 쿼리 예제
sqlite3 hummingbot_files/hummingbot_data/hummingbot_trades.db \
  "SELECT timestamp, trading_pair, order_type, amount, price FROM trades ORDER BY timestamp DESC LIMIT 10;"

# strategies/my_custom_mm.py
from decimal import Decimal
from hummingbot.strategy.script_strategy_base import ScriptStrategyBase
from hummingbot.core.data_type.common import OrderType, TradeType

class CustomMarketMaker(ScriptStrategyBase):
    """
    Dynamic spread market maker that adjusts based on volatility.
    """
    spread_base = Decimal("0.005")      # 0.5% 기본 스프레드
    spread_multiplier = Decimal("2.0")   # 변동성 높을 때 스프레드 2배
    order_amount = Decimal("0.001")     # 주문당 BTC 수량
    order_refresh_time = 30.0           # 초
    volatility_threshold = Decimal("0.02")  # 2% 가격 변동 = 변동성

    def __init__(self):
        super().__init__()
        self.last_mid_price = None
        self.is_volatile = False

    def on_tick(self):
        mid_price = self.connectors["binance"].get_mid_price("BTC-USDT")
        
        # 변동성 감지
        if self.last_mid_price:
            change = abs(mid_price - self.last_mid_price) / self.last_mid_price
            self.is_volatile = change > self.volatility_threshold
        
        self.last_mid_price = mid_price
        
        # 스프레드 조정
        spread = self.spread_base
        if self.is_volatile:
            spread *= self.spread_multiplier
        
        buy_price = mid_price * (Decimal("1") - spread)
        sell_price = mid_price * (Decimal("1") + spread)
        
        # 기존 주문 취소
        self.cancel_all_orders()
        
        # 신규 주문 배치
        self.buy("binance", "BTC-USDT", self.order_amount, OrderType.LIMIT, buy_price)
        self.sell("binance", "BTC-USDT", self.order_amount, OrderType.LIMIT, sell_price)

    def cancel_all_orders(self):
        for order in self.get_active_orders("binance"):
            self.cancel(order)

# 인벤토리 스큐용 전략에 추가
    def calculate_inventory_skew(self):
        """인벤토리 비율 기반 주문 크기 조정."""
        base_balance = self.connectors["binance"].get_balance("BTC")
        quote_balance = self.connectors["binance"].get_balance("USDT")
        
        mid_price = self.connectors["binance"].get_mid_price("BTC-USDT")
        base_value = base_balance * mid_price
        total_value = base_value + quote_balance
        
        inventory_ratio = base_value / total_value
        target_ratio = Decimal("0.5")  # 50/50 목표
        
        # 인벤토리 기반 주문 스큐
        if inventory_ratio > target_ratio:
            # BTC 과보유, 매수 크기 감소
            self.buy_multiplier = Decimal("0.5")
            self.sell_multiplier = Decimal("1.5")
        else:
            self.buy_multiplier = Decimal("1.5")
            self.sell_multiplier = Decimal("0.5")

# 역사적 거래 데이터 다운로드
python scripts/download_historical_data.py \
  --exchange binance \
  --trading-pair BTC-USDT \
  --start-date 2026-01-01 \
  --end-date 2026-03-31 \
  --interval 1m

# 백테스트 실행
python scripts/backtest.py \
  --strategy pure_market_making \
  --config conf/strategies/pmm_btc.yml \
  --data data/binance_BTC-USDT_1m.csv \
  --output results/btc_pmm_backtest.html

# 설정에서 페이퍼 트레이딩 활성화
paper_trade_enabled: true
paper_trade_account_balance:
  BTC: 1.0
  USDT: 50000.0

# 페이퍼 트레이드는 [PAPER] 접두사로 표시
>>> status
  Markets:
    [PAPER] binance  BTC-USDT  67,234.50  67,245.00  67,239.75

# docker-compose.yml
version: '3.8'

services:
  hummingbot:
    image: hummingbot/hummingbot:2.0.0
    container_name: hummingbot_prod
    restart: unless-stopped
    volumes:
      - ./conf:/conf
      - ./logs:/logs
      - ./data:/data
    environment:
      - CONFIG_PASSWORD=${HBOT_PASSWORD}
      - STRATEGY=pure_market_making
      - CONFIG_FILE=pmm_btc_usdt.yml
    logging:
      driver: "json-file"
      options:
        max-size: "50m"
        max-file: "5"
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '1.0'
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:15888/')"]
      interval: 30s
      timeout: 10s
      retries: 3

# 1. IP 화이트리스트 API 키 사용 (Binance 지원)
# 2. API 키에서 출금 제한 활성화
# 3. 격리된 Docker 네트워크에서 실행
# 4. 설정 파일 암호화

# 민감한 설정 암호화
openssl enc -aes-256-cbc -salt -in secrets.yml -out secrets.yml.enc

# 최신 이미지 가져오기
docker pull hummingbot/hummingbot:latest

# 기존 컨테이너 중지 및 제거
docker stop hummingbot && docker rm hummingbot

# 동일한 볼륨 마운트로 다시 시작
docker run -it --name hummingbot \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_conf,destination=/conf" \
  --mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_logs,destination=/logs" \
  hummingbot/hummingbot:latest