김치프리미엄 차익거래 자동 실행 봇

01배경과 고객 요구사항

고객은 업비트 원화 시장과 바이낸스 달러 시장에서 같은 코인의 가격이 벌어지는 순간을 노리고 있었습니다. 이 격차는 몇 초 사이에 벌어졌다 좁혀집니다. 두 거래소 창을 번갈아 보며 손으로 주문을 넣어서는 타이밍을 잡을 수 없었습니다.

더 큰 문제는 한쪽만 체결되는 경우였습니다. 업비트에서는 매수가 됐는데 바이낸스 진입이 늦어지면, 차익을 노리던 포지션이 한 방향으로만 노출된 위험한 포지션이 됩니다. 손으로는 이걸 제때 막을 수 없었습니다.

요청은 이랬습니다. 두 거래소의 실질 프리미엄을 실시간으로 계산해 보여 주고, 설정한 임계값에 닿으면 양쪽에 동시에 진입할 것. 그리고 한쪽만 체결되면 그 노출을 자동으로 정리해 반쪽짜리 포지션이 남지 않게 할 것.

02구현 방식

업비트와 바이낸스의 실시간 시세를 함께 구독해 김치프리미엄을 계산하고, 임계값에 닿으면 양쪽 시장에 주문을 보냅니다.

• 두 거래소의 WebSocket을 함께 열어 호가를 동시에 받습니다.
• 환율, 수수료, 전송 시간을 빼고 실제로 남는 김프(%)를 계산합니다.
• 프리미엄이 설정값(예: +3% 이상)에 닿으면 업비트와 바이낸스에 동시에 주문을 보냅니다.
• 정해진 시간 안에 양쪽이 다 체결됐는지 확인합니다. 한쪽만 채워졌으면 반대 주문이나 취소로 노출을 없앱니다.
• 포지션 규모는 리스크 한도를 넘지 않게 자동으로 조절하고, 진행 상황은 텔레그램으로 알립니다.

진입 신호가 뜨면 두 거래소에 각각 주문을 보내지만, 내부에서는 둘을 한 쌍으로 묶어 관리합니다. 한쪽이 실패하면 나머지 한쪽도 같이 정리되므로, 업비트만 사고 바이낸스는 못 산 상태가 남지 않습니다.

03한쪽만 체결될 때의 처리

• 두 거래소에 거의 동시에 주문을 보내고, 설정한 시간 안에 양쪽 체결이 확인되지 않으면 미완결로 판정합니다.
• 한쪽만 체결되면 그 포지션을 반대 주문으로 청산하거나 미체결 주문을 취소해서 한 방향 노출을 0으로 만듭니다.
• 원/달러 환율, 양쪽 거래 수수료, 전송 수수료와 전송 시간을 반영하고도 차익이 남을 때만 진입합니다.
• 양쪽 잔고와 호가 잔량을 보고 주문 수량을 실행 가능한 만큼으로 맞춰 과다 진입을 막습니다.

04주요 기능

• 업비트와 바이낸스 시세, 실질 프리미엄(%)을 한 화면에서 실시간으로 봅니다.
• 프리미엄이 설정값에 닿으면 양쪽 거래소에 동시에 주문합니다.
• 한쪽만 체결된 채 시간이 지나면 자동으로 취소하거나 청산합니다.
• 최대 노출과 1회 진입 한도는 설정값으로 정합니다.
• 진입, 체결, 미완결 취소, 오류를 텔레그램으로 바로 알립니다.

05제작 과정 (약 3~4주)

• 1주차에는 업비트와 바이낸스의 실시간 시세를 동시에 받도록 연결하고, 환율, 수수료, 전송 시간을 반영하는 프리미엄 계산을 만들었습니다.
• 2~3주차에 임계값 동시 진입, 체결 타임아웃과 양방향 자동취소, 포지션 규모 조절과 리스크 한도, 텔레그램 알림을 구현했습니다.
• 4주차에는 서버에 배포하고, 소액 실계좌로 동시 진입과 자동취소가 실제로 동작하는지 확인한 뒤 인수인계했습니다.

06납품 결과물

• 차익거래 실행 봇
• 실시간 김프 모니터 화면
• 체결 안전장치와 리스크 설정 (임계값, 타임아웃, 한도 조정)
• 텔레그램 알림 봇 연동
• 사용설명서, API와 서버 설정 가이드
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08관련 사례