빗썸 자동매매 봇
Bithumb API 맞춤 제작

빗썸(Bithumb)의 KRW·BTC 마켓에서 24시간 동작하는 자동매매 봇을 맞춤 제작합니다. 국내 두 번째로 큰 원화 마켓을 보유한 거래소로, 업비트와 함께 운영하면 거래소 간 차익거래(김치프리미엄 포함) 전략도 가능합니다. 빗썸 고유의 호가 단위 규칙·nonce 시간 보정·자기매칭 자동 취소 등 함정을 모두 반영해 안정성 있게 제작합니다.

빗썸 자동매매 주요 유형

• KRW 마켓 RSI·MACD 기반 매매 — BTC·ETH·XRP 등 주요 코인 지표 추종
• 그리드 봇 — 횡보장 코인에 일정 간격 매수·매도 반복
• 거래소 간 차익거래(아비트라지) — 빗썸 ↔ 업비트 / 빗썸 ↔ 바이낸스 가격차 자동 실행
• 김치프리미엄 자동 트래킹 — 국내·해외 가격차 알림 + 임계치 초과 시 자동 진입
• 조건부 매수·매도 — 특정 가격 도달 시 시장가/지정가 분기 실행
• 실시간 알림 봇 — 매매 외 시세·거래량·신규 상장 텔레그램 알림

기술 구조

핵심 기능 구성 요소

• nonce 시간 보정: 빗썸 서버 시간과 PC 시간 오프셋 자동 측정·보정
• 호가 단위 자동 처리: 가격대별 8단계 호가 규칙 적용 (실측 검증)
• 자기매칭 회피: 본인 매수·매도 호가 충돌 사전 감지로 강제 취소 방지
• API 1.0 / 2.0 선택: 안정성 우선이면 1.0(HMAC), 신규 기능 활용이면 2.0(JWT)
• 잔고·미체결 조회 폴링: 주문 체결 상태 실시간 추적
• 리스크 관리: 일일 최대 손실 한도, 단일 코인 최대 비중, 동시 보유 코인 수 제한
• 알림: 텔레그램 진입·청산·오류 즉시 알림 + 일일 손익 리포트

빗썸 API는 실제로 어떻게 호출하나

아래는 2026년 8월 기준 빗썸 API 2.0(JWT) 기준입니다. REST 기본 주소는 https://api.bithumb.com이고, 시세 같은 Public API는 인증 없이, 자산·주문 같은 Private API는 JWT 토큰이 필요합니다.

1. 인증 토큰 만들기 — 파라미터가 있으면 규칙이 달라진다

파라미터가 없는 요청(예: 전체 자산 조회)은 페이로드 세 필드로 끝납니다.

import jwt, uuid, time, requests

API_URL = "https://api.bithumb.com"

payload = {
    "access_key": ACCESS_KEY,
    "nonce": str(uuid.uuid4()),          # 요청마다 새로 만든다
    "timestamp": round(time.time() * 1000),   # 밀리초
}
token = jwt.encode(payload, SECRET_KEY)      # HS256

res = requests.get(API_URL + "/v1/accounts",
                   headers={"Authorization": f"Bearer {token}"}, timeout=5)

파라미터가 있는 요청은 여기에 두 필드가 더 붙습니다. 쿼리 문자열을 SHA512로 해시한 값이 query_hash입니다.

import hashlib
from urllib.parse import urlencode

param = {"market": "KRW-BTC"}
query = urlencode(param).encode()
query_hash = hashlib.sha512(query).hexdigest()

payload = {
    "access_key": ACCESS_KEY,
    "nonce": str(uuid.uuid4()),
    "timestamp": round(time.time() * 1000),
    "query_hash": query_hash,
    "query_hash_alg": "SHA512",      # 문자열 고정값
}
token = jwt.encode(payload, SECRET_KEY)

res = requests.get(API_URL + "/v1/orders/chance",
                   params=param,
                   headers={"Authorization": f"Bearer {token}"}, timeout=5)

2. 주문 — 업비트 코드를 옮기면 여기서 막힌다

빗썸 주문은 POST /v2/orders입니다. 파라미터명이 order_type이라는 점이 가장 자주 걸립니다.

3. 401이 떴을 때 확인 순서

빗썸은 오류를 error.name과 error.message로 돌려줍니다. 이름만 보면 원인이 거의 특정됩니다.

{
  "error": {
    "name": "invalid_query_payload",
    "message": "Jwt의 query를 검증하는데 실패하였습니다."
  }
}

cross_trading은 빗썸 봇에서 특히 자주 보는 항목입니다. 내 매수 호가와 내 매도 호가가 겹치면 주문이 취소되므로, 그리드 봇처럼 양방향 호가를 동시에 거는 전략은 주문 전에 자기 호가 충돌을 먼저 검사해야 합니다. 그리드 설계 자체는 그리드 매매 봇 가이드에 정리돼 있습니다.

제작 비용·기간 가이드

자주 묻는 질문

invalid_query_payload 오류는 왜 나나요?

JWT 안의 query_hash와 실제로 보낸 쿼리가 다를 때 납니다. 쿼리 문자열을 두 번 만들면 파라미터 순서·인코딩이 미세하게 달라져 검증에 실패합니다. 한 번 만든 문자열을 해시와 요청에 같이 쓰십시오. 배열은 key[]=value로 펼쳐야 합니다.

업비트 봇 코드를 빗썸에 그대로 쓸 수 있나요?

인증 구조는 비슷하지만 주문에서 갈립니다. 빗썸은 POST /v2/orders에 order_type을 쓰고, 시장가 매수는 price(금액)·시장가 매도는 volume(수량)을 넣습니다. 두 값 모두 문자열입니다. 거래소별 어댑터를 나누는 편이 안전합니다. 업비트 쪽 구현은 업비트 자동매매를 참고하십시오.

업비트와 비교하면 뭐가 나은가요?

업비트가 거래량·유동성 1위이지만, 빗썸은 일부 알트코인 거래량과 수수료 등급제에서 차별화됩니다. 차익거래 시에는 두 거래소를 동시에 운영하는 게 가장 흔한 구조입니다. 알고랩은 두 API 모두 익숙해 병행 봇 제작이 효율적입니다.

API 1.0(HMAC)과 2.0(JWT) 중 뭐 써야 하나요?

안정성·기존 코드 호환성이 우선이면 1.0, 신규 기능·OAuth 흐름이 필요하면 2.0입니다. 신규 제작 의뢰 시 알고랩이 요구사항 보고 결정해드립니다. 두 API를 모두 지원하는 봇으로 제작도 가능합니다.

빗썸이 거래정지·임시 점검할 때는 어떻게 처리되나요?

API 응답으로 거래정지 종목·점검 시간을 자동 감지해 신규 진입을 차단합니다. 보유 종목은 그대로 유지하고 점검 종료 후 재시작 시 보유·미체결 상태를 자동 인계합니다.

김치프리미엄 차익거래가 실제로 가능한가요?

API 차원에서는 충분히 구현 가능합니다. 다만 출금 한도·트래블룰·거래소별 입출금 시간 차이 등 운영 측면 제약이 있어, 매매 자동화는 알고랩이 맡고 자금 이동·출금은 의뢰자가 수동으로 운영하는 구조가 일반적입니다. 자세한 견적은 상담에서.

제작 사례

빗썸 자동매매 제작 사례는 포트폴리오에서 확인하실 수 있습니다. 업비트와 함께 운영하는 차익거래 사례도 다수 보유하고 있습니다.