Upbit/KRX 지원 여부 — Freqtrade, Hummingbot, OctoBot 비교

2026년 4월 기준으로 Upbit(KRW) 자동매매를 현실적으로 시도할 수 있는 오픈소스 봇은 사실상 Freqtrade 하나이며, 그마저도 CCXT 기반의 커뮤니티 수준 지원에 가깝다.

개요

이 노트는 한국 사용자 관점에서 많이 헷갈리는 질문, 즉 Upbit과 KRX를 Freqtrade / Hummingbot / OctoBot에서 쓸 수 있는가를 빠르게 판단할 수 있도록 정리한 것이다.

핵심 결론은 간단하다.

  • Upbit: Freqtrade에서는 가능하지만 공식 지원은 아님
  • KRX: 세 도구 모두 사실상 불가
  • Hummingbot / OctoBot: Upbit 미지원

1) Freqtrade

Upbit 지원 여부

가능. 다만 엄밀히 말하면 공식 지원 거래소는 아니고, CCXT를 통한 비공식/커뮤니티 수준 지원이다.

근거는 다음과 같다.

  • Freqtrade는 거래소 연결을 CCXT에 크게 의존한다.
  • 2026-04-13-ccxt-crypto-trading-library 기준으로 CCXT는 110개 이상의 거래소를 지원하며, Upbit도 포함한다.
  • Upbit에서는 fetchOHLCV, createOrder, fetchMyTrades 같은 기본 기능을 쓸 수 있다.
  • 그러나 Freqtrade가 공식 테스트 및 지원 대상으로 명시한 거래소 목록에는 Upbit이 없다.

즉, “설정해서 붙일 수는 있지만 안정성 보장은 약하다”가 정확한 표현이다.

실무적 의미

  • 과거 커뮤니티에서 KRW 페어를 연결해 쓴 사례는 있다.
  • 하지만 다음 영역은 제한 또는 버그 가능성을 염두에 둬야 한다.
    • 거래 내역 조회
    • 시장가 주문
    • 특수 주문 타입
    • 거래소별 예외 처리

따라서 실제 자금 투입 전에는 다음 순서를 지키는 편이 안전하다.

  1. 백테스팅
  2. Dry-run / Paper trading
  3. 소액 실거래
  4. 충분한 로그 관찰 후 확대

KRX 지원 여부

불가능.

KRX는 암호화폐 거래소가 아니라 한국 주식·선물 시장 인프라다. Freqtrade는 CCXT 기반 크립토 거래소 자동매매 도구이므로 KRX를 직접 지원하지 않는다.

Upbit 설정 예시

"exchange": {
  "name": "upbit",
  "key": "YOUR_UPBIT_API_KEY",
  "secret": "YOUR_UPBIT_API_SECRET",
  "ccxt_config": {
    "enableRateLimit": true
  },
  "pair_whitelist": ["BTC/KRW", "ETH/KRW"],
  "pair_blacklist": []
}

주의 포인트

  • Upbit API 키/시크릿 필요
  • enableRateLimit: true 권장
  • KRW 페어 특성상 거래소별 수수료/최소 주문 단위를 반드시 확인
  • 실거래 전 Dry-run 필수

2) Hummingbot

Upbit 지원 여부

없음.

Hummingbot은 Binance, Bybit 등 일부 주요 CEX/DEX 커넥터에 집중되어 있고, Upbit 커넥터는 없다.

KRX 지원 여부

없음.

KRX는 Hummingbot의 거래소 모델 밖에 있다.

3) OctoBot

Upbit 지원 여부

없음.

OctoBot은 Binance, OKX, Bybit, Bitget, KuCoin 등 주요 글로벌 크립토 거래소 중심으로 공식 지원이 구성되어 있다. Upbit은 공식 지원 목록에 없다.

KRX 지원 여부

없음.

KRX는 OctoBot의 대상 거래소 범주가 아니다.

비교 요약

도구UpbitKRX해석
Freqtrade가능(비공식)불가CCXT 덕분에 붙일 수는 있으나 공식 보증은 약함
Hummingbot불가불가Upbit 커넥터 없음
OctoBot불가불가Upbit 공식 지원 없음

결론

한국 사용자 기준으로 Upbit(KRW) 자동매매를 오픈소스로 해보려면 Freqtrade가 사실상 유일한 현실적 선택지다. 다만 이 선택은 “완전 지원”이 아니라 “CCXT 경유의 실용적 우회”에 가깝다.

반면 KRX 자동매매는 이 세 도구의 범위를 벗어난다. KRX를 다루려면 별도의 한국 증권사 API, 국내 HTS/REST 연동, 또는 완전히 다른 자동매매 스택이 필요하다.

실전 권고

  • Upbit 자동매매 목적이면 Freqtrade + CCXT 조합을 우선 검토
  • 단, 커뮤니티 수준 지원이라는 점을 전제로 테스트 중심 접근 필요
  • Hummingbot / OctoBot은 한국 KRW 현물 자동매매 목적에는 맞지 않음
  • KRX는 완전히 다른 문제로 분리해서 봐야 함