김치프리미엄 차익거래 자동화 — 업비트·빗썸 vs 바이낸스 가격차 자동 트래킹·진입 가이드

국내 거래소(업비트·빗썸·코인원·코빗)와 해외 거래소(바이낸스·바이비트 등)의 같은 코인 가격이 다른 현상을 김치프리미엄이라 부릅니다. 이 가격차는 자동매매 입장에서 매력적인 차익거래 기회로 보이지만, 실제로는 API로 매매 자동화하는 부분보다 자금 이동·트래블룰·출금 한도 등 운영 측면 함정이 더 큰 영역입니다.

이 글은 김치프리미엄 차익거래를 자동화하려는 분께 실전에서 부딪히는 함정과 API 차원에서 자동화 가능한 영역, 그리고 알고랩이 이 분야 의뢰를 받을 때 어떻게 구조를 잡는지 정리합니다. "이거 자동화하면 돈 벌 수 있겠다"라고 단순히 생각하시기 전에 한 번 읽어보시면 좋을 내용입니다.

김치프리미엄이란 — 왜 발생하나

같은 BTC라도 업비트에서는 1억 원에 거래되고, 같은 시점 바이낸스에서는 $73,000(약 9,800만 원)에 거래되는 상황. 약 +2% 차이입니다. 이 가격차가 발생하는 구조적 이유:

• 국내 자금이 코인 시장으로 한쪽 방향만 흐름 — 출금 규제·환전 비용 등으로 양방향 차익이 어려움
• 국내 시장이 분리된 풀 — 외국인 거래 제한, KRW 기반 거래만 가능
• 심리적 요인 — 강세장에서 김프 확대, 약세장에서 김프 축소·역프(역김치프리미엄) 발생

역사적으로 김프는 0%~+30%까지 변동했고, 2018년에는 한때 +50%까지 치솟은 적도 있습니다. 평균은 0~+5% 수준.

API로 자동화 가능한 영역 vs 사람이 해야 하는 영역

이 부분이 가장 중요합니다. 김프 차익거래의 절반은 API로 자동화 안 됩니다.

그래서 김프 자동매매는 보통 "가격차 모니터링 + 임계치 알림 + 진입 의사결정 보조"까지 자동화하고, 실제 자금 이동은 사람이 수동으로 운영하는 하이브리드 구조가 일반적입니다.

김프율을 실제로 어떻게 계산하나 — API 실물

자동화되는 절반, 즉 시세 수집과 김프 계산은 생각보다 문턱이 낮습니다. 업비트와 바이낸스 모두 API 키 없이 조회할 수 있는 공개 시세 엔드포인트를 제공하기 때문에, 계좌를 만들기 전에도 계산 로직을 시험해 볼 수 있습니다.

업비트 — 원화 시세

조회할 종목을 markets 파라미터로 넘기면 배열이 돌아옵니다. 우리가 볼 필드는 trade_price(최종 체결가)와 timestamp입니다.

GET https://api.upbit.com/v1/ticker?markets=KRW-BTC,KRW-USDT

[
  {
    "market": "KRW-BTC",
    "trade_price": 98750000.0,
    "signed_change_rate": 0.0132,
    "acc_trade_price_24h": 412330000000.0,
    "timestamp": 1754500000000
  },
  {
    "market": "KRW-USDT",
    "trade_price": 1398.0,
    "timestamp": 1754500000000
  }
]

※ 위 값은 응답 형태를 보여 주기 위한 예시이며 특정 시점의 시세가 아닙니다.

바이낸스 — 달러 표시 시세

GET https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

{
  "symbol": "BTCUSDT",
  "price": "69850.00000000"
}

두 값을 합쳐 순수익까지 계산하기

명목 김프를 구하는 것은 나눗셈 한 줄이지만, 그 숫자는 실행 가능한 값이 아닙니다. 수수료와 슬리피지를 빼는 부분까지가 한 세트입니다.

import requests

def upbit_prices():
    r = requests.get("https://api.upbit.com/v1/ticker",
                     params={"markets": "KRW-BTC,KRW-USDT"}, timeout=3)
    d = {x["market"]: x for x in r.json()}
    return d["KRW-BTC"]["trade_price"], d["KRW-USDT"]["trade_price"]

def binance_btc_usdt():
    r = requests.get("https://api.binance.com/api/v3/ticker/price",
                     params={"symbol": "BTCUSDT"}, timeout=3)
    return float(r.json()["price"])

# 비용 가정 — 각자의 등급·경로로 반드시 교체할 것
FEE_KR    = 0.0005     # 국내 거래소 매도 수수료율
FEE_GLOBAL= 0.0010     # 해외 거래소 매수 수수료율
WITHDRAW  = 0.0008     # 코인 출금 수수료(거래대금 대비 환산)
SLIPPAGE  = 0.0010     # 양쪽 합산 슬리피지 가정

def kimp():
    krw_btc, krw_usdt = upbit_prices()
    usdt_btc = binance_btc_usdt()

    fair = usdt_btc * krw_usdt              # 해외가를 원화로 환산
    nominal = (krw_btc - fair) / fair       # 명목 김프

    cost = FEE_KR + FEE_GLOBAL + WITHDRAW + SLIPPAGE
    net  = nominal - cost                   # 실행 가능한 폭

    return {
        "명목김프(%)": round(nominal * 100, 3),
        "비용(%)":     round(cost * 100, 3),
        "순김프(%)":   round(net * 100, 3),
        "실행가능":    net > 0,
    }

print(kimp())
# {'명목김프(%)': 1.083, '비용(%)': 0.33, '순김프(%)': 0.753, '실행가능': True}

계산이 조용히 틀어지는 두 가지

세 번째는 감시 코인이 늘어날수록 반드시 만나는 문제입니다. 종목마다 따로 조회하면 종목 수가 그대로 초당 호출 수가 됩니다. 호출 한도를 넘기지 않게 설계하는 원리는 호출 제한 설계에, 실제로 한도에 걸렸을 때의 대응은 429 해결 사례에 정리돼 있습니다. 여기서 중요한 것은 호출 제한이 성능 문제가 아니라 정확도 문제라는 점입니다 — 한쪽 시세만 갱신이 멈추면 계산된 김프가 유령 숫자가 됩니다.

김프 자동매매 5가지 실전 함정

1. 출금 한도

국내 거래소는 일일·1회 출금 한도가 정해져 있습니다. 예: 업비트 KYC 1단계 일 5천만원, KYC 2단계 일 5억원. 차익거래 규모가 한도 안에 들어와야 작동. 한도를 초과하면 분할 출금 + 자금 이동 지연 → 김프가 변동되는 동안 차익이 소멸할 수 있음.

2. 트래블룰

2022년 시행된 트래블룰로 국내 ↔ 해외 거래소 간 코인 이동 시 송수신자 정보 공유가 의무화. 실무에서 발생하는 영향:

• 국내 거래소에서 해외 미인증 거래소로 직접 출금 불가
• 화이트리스트(사전 등록) 거래소만 송금 가능
• 송수신자 KYC 정보 일치 필수

이게 김치프리미엄 차익거래의 가장 큰 실무 장벽입니다.

3. 입출금 시간 차이

BTC 1개를 업비트에서 바이낸스로 보낼 때 10~60분이 걸립니다 (블록체인 확인 + 거래소 처리). 이 시간 동안 김프가 변동되면 차익이 소멸하거나 역으로 손실 가능. "진입 시 +5% → 자금 도착 시 +1%"가 흔한 시나리오.

4. 거래소 점검·임시 출금 정지

국내 거래소가 임시 점검·출금 정지하면 자금이 묶임. 이때 양쪽 거래소 포지션이 헤지되지 않은 채 가격이 움직이면 큰 손실. 실제로 2017년·2021년 강세장에서 거래소 점검 빈도가 높아 차익거래 봇이 큰 손실을 본 사례 다수.

5. 스테이블코인 디페그

USDT를 통해 자금 이동하는 경우, USDT 자체가 디페그(USD 대비 가치 변동)되면 추가 위험 발생. 2022년 USDC 일시 디페그(0.88) 사건 같은 위험.

2026-09-06 업데이트 — 송금 구간을 API 문서로 다시 확인했다

김프 차익거래에서 시간과 돈이 새는 곳은 주문이 아니라 송금 구간입니다. 이 절은 업비트 개발자 문서 원문(2026-09-06 확인)을 대조한 것입니다. 빗썸·바이낸스는 정책이 달라 각 거래소 공식 문서를 같은 방식으로 확인하셔야 합니다.

① 출금 허용 주소는 API로 등록할 수 없다

업비트 디지털 자산 출금 요청 문서의 원문입니다 — "API를 통한 디지털 자산 출금시 출금 대상 주소를 반드시 사전에 출금 허용 주소로 등록해야 합니다. 출금 허용 주소는 업비트 홈페이지를 통해 등록할 수 있으며 API를 통한 등록은 불가합니다."

② net_type은 필수이고 network_name은 식별자가 아니다

같은 코인이라도 어느 체인으로 보내느냐에 따라 수수료와 도착 시간이 완전히 달라집니다. 업비트는 이를 네트워크 타입 net_type으로 지정하며 출금 시 필수 파라미터입니다. 문서는 두 필드를 명확히 구분합니다.

공식 안내는 값을 상수로 박지 말고 출금 허용 주소 목록 조회 API의 응답에서 net_type을 그대로 참조하라고 명시합니다. 체인을 잘못 지정한 송금은 되돌릴 수 없습니다.

③ 보내기 전에 봐야 할 것 — 출금 가능 정보 조회

잔고만 보고 출금을 걸면 한도·인증·지갑 상태에서 걸립니다. 업비트 출금 가능 정보 조회는 네 묶음을 한 번에 돌려줍니다.

특히 withdraw_limit.remaining_daily(일일 잔여한도)입니다. 김프가 벌어져도 오늘 더 보낼 수 있는 금액이 없으면 회차가 거기서 끊깁니다. 진입 크기는 onetime·remaining_daily·minimum으로 먼저 상한을 자른 뒤 김프율을 보고, can_withdraw가 거짓이면 시작하지 않아야 합니다.

④ 입출금 상태 API를 매매 신호로 쓰지 말라 — 공식 경고

거래소 점검·입출금 중단은 김프봇의 최대 위험이고(위 함정 4), 그래서 입출금 서비스 상태 조회 API를 신호로 쓰고 싶어집니다. 업비트 문서는 이것을 명시적으로 말립니다.

상태 값은 working · withdraw_only(출금만) · deposit_only(입금만) · paused(중단) · unsupported(미지원) 다섯이고 block_elapsed_minutes가 함께 옵니다. 출금만·입금만이 따로 있다는 점이 중요합니다 — 한쪽만 막혀도 왕복 경로가 끊기므로 양쪽 거래소를 방향까지 나눠 확인해야 합니다.

⑤ 같은 거래소 안이라면 수수료 없는 경로가 있다

업비트는 출금 유형을 transaction_type으로 나눕니다. 일반 출금(default)은 실제 블록체인 트랜잭션이라 확정 시간과 수수료가 발생하고, 바로 출금(internal)은 블록체인을 쓰지 않아 문서 기준 약 1분 내외 반영·수수료 없음입니다. 다만 받는 쪽이 업비트 회원의 지갑 주소여야 합니다.

⑥ 요청 형식과 권한 — 자잘하지만 자주 막히는 것

• POST는 반드시 JSON 본문 — Urlencoded Form 방식은 2022년 3월 1일부로 지원이 종료됐고 정상 동작을 보장하지 않습니다.
• 권한이 나뉘어 있다 — 출금 요청은 [출금하기], 출금 가능 정보 조회는 [출금조회] 권한이 설정된 키가 필요하고, 없으면 out_of_scope 오류가 납니다. 조회만 되는 키로 송금 로직을 시험하면 마지막 단계에서 막힙니다.
• 호출 한도는 초당 30회, [Exchange 기본 그룹] 공유 — 잔고·주문·출금 조회가 같은 한도를 나눠 씁니다. 시세를 촘촘히 폴링하는 김프봇이라면 호출 한도 설계를 함께 보십시오.
• 트래블룰 검증은 별도 API — 타 거래소에서 업비트로 입금할 때 계정주 확인을 위해 입금 UUID 또는 TxID로 검증을 요청하는 엔드포인트가 따로 있습니다. 함정 3의 트래블룰이 봇이 호출해야 하는 단계로 존재한다는 뜻입니다.

실전 자동화 구조 — 알고랩이 만드는 방식

위 함정을 모두 고려하면 실용적 김프 자동화는 다음 4단계 구조입니다:

1단계 — 실시간 김프 모니터링

업비트·빗썸·코인원·코빗 4개 국내 거래소와 바이낸스·바이비트 등 해외 거래소의 시세를 동시에 WebSocket으로 받아 실시간 가격차 계산. 환율(USD/KRW)도 한국은행 또는 외환 API로 실시간 반영.

김프(%) = (업비트 BTC/KRW - 바이낸스 BTC/USDT × USDT/KRW) /
         (바이낸스 BTC/USDT × USDT/KRW) × 100

2단계 — 임계치 도달 알림

사용자가 설정한 임계치(예: ±5%) 돌파 시 텔레그램으로 즉시 알림. 알림에는 현재 김프, 양쪽 거래소 가격, 예상 수익률, 출금 예상 시간 등 의사결정 정보가 모두 포함됩니다.

3단계 — 양쪽 거래소 동시 진입 (선택적 자동화)

의뢰자 결정에 따라 알림만 받고 사람이 수동 진입할지, 자동 진입까지 할지 선택. 자동 진입 시:

• 국내 거래소 BTC 매도 + 해외 거래소 BTC 매수 동시 주문
• 한쪽만 체결되면 즉시 자동 취소·역청산 (양방향 위험 회피)
• 슬리피지 가드 — 호가창 깊이가 부족하면 진입 차단

4단계 — 수렴 시 청산 (선택적)

가격차가 목표 수준으로 수렴하면 자동 청산. 단, 이 시점에 자금이 거래소 사이를 이동 중일 수 있어 청산 가능 여부는 보유 코인 위치에 달림.

김프 자동매매를 시작하기 전 체크리스트

1. 국내 거래소 KYC 2단계+ — 출금 한도 확보
2. 화이트리스트 등록 — 트래블룰 대응으로 송신·수신 거래소 사전 등록
3. 해외 거래소 가입 — 바이낸스·바이비트 등 KYC 완료
4. USDT 출금 경로 확인 — TRC-20 vs ERC-20 수수료·시간 비교
5. 환율 API 연동 — KRW/USD 실시간 환율 (네이버 금융 또는 한국은행)
6. 예상 수익 vs 비용 시뮬레이션 — 거래 수수료 + 출금 수수료 + 환전 비용 + 슬리피지
7. 비상 시나리오 준비 — 거래소 점검 시 대응 매뉴얼

이 7가지가 모두 준비되어야 실전 김프 자동매매가 작동합니다. 1~2개 빠지면 첫 운영에서 손실이 발생할 가능성이 높습니다.

알고랩 김프 봇 표준 기능

알고랩이 김프 차익거래 봇을 제작할 때 표준으로 포함하는 기능:

• 4개 국내 + 2개 해외 거래소 동시 모니터링 — 모든 조합의 김프 실시간 계산
• 호가창 깊이 가중 가격 — 단순 시세가 아닌 실제 체결 가능 가격 기준
• USD/KRW 환율 실시간 반영 — 외부 API 다중 소스 (네이버 + 한국은행)
• 거래 수수료·출금 비용·슬리피지 자동 차감 후 순수익 계산
• 임계치별 단계 알림 — 주의(±2%)·기회(±5%)·강력 기회(±10%)
• 거래소 점검·출금 정지 자동 감지 — 알림에 정지 거래소 표시
• 동시 양방향 주문 + 한쪽 미체결 시 자동 취소·역청산
• 일별·월별 김프 통계 리포트 — 운영 데이터 누적

제작 비용·기간 가이드

마무리 — 현실적 기대치 설정

김치프리미엄 차익거래는 매력적이지만 "자동매매 봇만 만들면 매월 안정적 수익"은 더 이상 작동하지 않는 명제입니다. 트래블룰·규제·자금 이동 비용 때문에 순수익률이 명목 김프보다 훨씬 낮은 경우가 많습니다.

그렇다고 가치가 없는 건 아닙니다. 알림 봇 형태로 운영하면서 큰 김프 발생 시점에만 수동 진입하는 하이브리드 구조가 현실적입니다. 또는 다른 자동매매(메이저 코인 그리드 봇 등)와 병행해 분산 자산의 한 축으로 가져가는 방식도 가능합니다.

자주 묻는 질문

은행 환율과 KRW-USDT 시세 중 뭘 기준으로 잡아야 하나요?

실제로 자금이 통과하는 경로를 기준으로 잡는 것이 원칙입니다. 스테이블코인으로 옮길 계획이라면 업비트의 KRW-USDT 시세가, 은행 송금을 거친다면 고시 환율이 더 가깝습니다. 다만 어느 쪽이든 명목값이라는 사실은 같습니다. 실행 여부는 수수료를 뺀 순김프로만 판단하세요.

모니터링만 하는 봇도 API 키가 필요한가요?

시세 조회만 한다면 필요 없습니다. 업비트와 바이낸스 모두 공개 시세 엔드포인트를 인증 없이 제공합니다. 주문·잔고·출금으로 넘어가는 순간부터 키가 필요하고, 그때는 출금 권한을 꼭 필요한 경우가 아니면 열지 않는 것이 안전합니다. 키 관리 원칙은 API 키 보안 가이드를 참고하세요.

감시 코인을 늘리면 뭐가 문제가 되나요?

호출 수가 종목 수만큼 늘어납니다. 그러면 한도에 걸려 한쪽 거래소 시세만 멈추고, 그 상태에서 계산된 김프는 실제와 다른 값이 됩니다. 종목을 묶어 한 번에 조회하거나 실시간 구독으로 전환하는 것이 정석입니다. 자세한 구조는 호출 제한 설계에 있습니다.

거래소 수수료 말고 또 어떤 비용이 있나요?

코인 출금 수수료가 대표적이고, 여기에 슬리피지가 사실상 비용으로 붙습니다. 국내 주식 자동매매와 달리 증권거래세는 없지만, 대신 거래소별 메이커·테이커 요율과 네트워크별 출금 수수료가 갈립니다. 시장별 비용 구조가 어떻게 다른지는 증권사 API 수수료에서 비교 관점으로 정리했습니다.

차익거래 전략 전반이 궁금하면 뭘 보면 되나요?

김프는 차익거래의 한 갈래일 뿐입니다. 거래소 간·현선물 간 차익 등 유형별 정리는 차익거래 완전 가이드에, 코인 자동매매 전반의 구조는 코인 자동매매 가이드에 있습니다.