멜로디봇 김프매매 최신버전 사용설명서_(PART 1)

안녕하세요
 
이번에 배포된 김프매매 프로그램에대한 사용설명서 부분을 천천히 하나씩 살펴보도록 하겠습니다.
 
.
.
.
 

 

.
.
.
 

김프 자동매매 프로그램 사용법: UI 설명과 실전 팁

 
국내 김치 프리미엄(김프) 상황을 이용한 자동 매매 프로그램의 UI를 처음 접한다면 다소 복잡해 보일 수 있습니다.
 
김치 프리미엄은 국내 코인 가격이 해외보다 높을 때 발생하는 가격 차이를 말합니다.
 
이 프로그램은 그런 가격 차이를 노려  싸게 사고 비싸게 파는 차익거래(아비트리지)를 자동으로 해주는 봇입니다.
 
이번 글에서는 프로그램의 각 UI 구성 요소를 초보자도 쉽게 이해할 수 있도록 튜토리얼 형식으로 설명하고,
 
실제 사용 예시와 팁까지 함께 살펴보겠습니다.
 
 

전체 UI 한눈에 보기

2025-05-27일 첫버전

 
프로그램 메인 화면은 크게 세 부분으로 나눌 수 있습니다.
 
왼쪽 패널에는 거래소 선택, 계좌 잔고와 거래 로그가 표시되고, 오른쪽 패널에는 자동매매를 위한 각종 조건 설정 영역이 있습니다.
 
그리고 하단 영역에서는 실시간 자산 변화와 뉴스 헤드라인을 볼 수 있어요.
 
이러한 섹션들이 서로 연동되어 자동매매의 준비-실행-모니터링 흐름을 구성합니다.
 

• 왼쪽: 현재 선택된 국내/해외 거래소의 잔고 현황과 프로그램 로그
• 오른쪽: 김프 거래 조건 입력 및 자동매매 제어 영역
• 하단: 자산 증감 현황 요약 및 실시간 뉴스 피드

 
먼저 왼쪽부터 차례로 자세히 살펴보겠습니다.

 

왼쪽 패널: 거래소 선택, 잔고 정보 및 로그

 
거래소 선택 확인:

 
왼쪽 상단에서 국내 거래소와 해외 거래소를  처음시작시 선택하신 거래소명을 확인할수있습니다.
 
스크린샷에서는 국내 거래소로 Bithumb, 해외 거래소로 Okx가 선택되어 있습니다.
 
프로그램이 이 두 거래소 간의 가격 차이를 모니터링하고 거래를 실행하게 됩니다.
 
필요에 따라 국내 거래소를 Upbit로, 해외 거래소를 Bybit로 변경할 수도 있습니다.
(프로그램 종료 후, 재선택 실행 - API 미리 입력필수 key.txt 파일)
 
API 키를 미리 설정파일에 넣어두면(예: key.txt 파일에 각 거래소의 API 키와 시크릿 입력) 프로그램이 해당 거래소들과
연결되어 잔고 정보를 불러옵니다.

API 키발급하기!
https://allmusicstory.tistory.com/m/127

업비트,빗썸,OKX,Bybit  거래소의 Api Key 발급 및 OKX,Bybit 거래셋팅 하기

 
 
계좌 잔고 표시: 거래소를 연결하면 해당 계좌 잔액과 코인 보유량이 왼쪽 패널에 실시간으로 표시됩니다.
 
예를 들어 Bithumb 아래에 KRW 잔고: 62,200,000처럼 원화 잔액이, 코인 수량: 0.00028처럼 선택 코인의 수량
(예를 들어 BTC 수량)이 나타납니다.
 
Okx 쪽에는 USDT 잔고: 4,205 처럼 달러 테더 잔액과 코인 수량이 표시되지요.
 
이로써 국내 원화 자금과 해외 달러자금(USDT 테더)이 얼마나 있는지 한눈에 파악할 수 있습니다.

 
또한 현재 시장 가격도 함께 볼 수 있는데, 보통 제1매도호가와 제1매수호가 형태로 표시되어
해당 거래소에서의 코인 호가창 최상단 가격(팔 때 가격과 살 때 가격)을 알려줍니다.
 
이를 통해 국내와 해외 거래소 가격을 비교하여 현재 김프가 얼마나 되는지 가늠할 수 있습니다.
(김프 % 계산은 환율을 고려해 국내 가격과 해외 가격을 비교합니다.)
 
 
 
실시간 환율 및 김프 정보: 잔고 아래에는 환율/ 호가테더 / 호가김프 / 진입금액 / DCA 정보 섹션이 있습니다.
 
여기서 현재 사용되는 환율(예: 실시간 환율: 1373.39원/USD)이 표시되어 있고,
실시간으로 계산된 현재 김프도 확인할 수 있습니다.
 
김프는 보통 퍼센트(%)로 표시되며, 프로그램이 국내외 가격과 환율을 바탕으로 자동 계산해줍니다.
 

실시간환율 대비, 국내와 국외호가에대한 김프% 및 테더환산가격실시간

 
예를 들어 화면에 현재 김프: 0.92%처럼 나타나면, 국내 가격이 해외보다 0.92% 높다는 뜻입니다.
이 값은 거래 조건으로 설정한 진입/탈출 김프 대비 얼마나 차이나는지도 확인할 수 있어요.
 
매도호가김프%와 매수호가김프%는  국내와 해외의 현재 실시간 호가금액을 기준으로 차이율을 표시해줍니다.
실제로는 국내에 상장된 테더(USDT) 빗썸,업비트의 금액은 1385 / 1386원이지만, 실호가는 1386.03 으로 호가에도
차이가 더 높다는것을 의미합니다.  (실제 테더거래를 진행했을때에는, 이러한 호가기준의 빠른 유동성매매는 기대하기어렵습니다.)  그래서 봇을이용한 순간적인 유동성 호가테더의 급상의 순간포착을하기위한 봇사용이 유용합니다.
 
 
 

 
Tip: 환율은 기본적으로 실시간 환율을 따르지만, UI 상단의 “네트워크 에러 표시” 옵션 옆에 “환율 연동” 기능을
사용할 수도 있습니다.
환율 연동을 체크하면 외부 환율 API와 연동되어 환율값이 자동 갱신되고, 체크 해제 시에는 옆에 표시된 기준 환율 값
(예: 1369.49)을 기준으로 고정 계산합니다.
 
초보자의 경우 특별한 이유가 없다면 실시간 환율 연동을 켜 두는 것을 권장합니다.
 
 
프로그램 로그: 왼쪽 패널 상단의 큰 텍스트 창은 실시간 로그 창입니다. 프로그램의 각종 동작과 메시지가 시계열로 출력됩니다.
 
 

 
예를 들어 하기와같이 시간과, 설정된 값, 진입시 로그가 쌓이게됩니다.
 
[2025/05/27 18:33:28]
선택된 DCA 잔고용 코인: SOL
[2025/05/27 18:33:29]
선택된 거래소: bithumb, okx
[2025/05/27 18:33:33]
분할 자동매매 시작 (0.15초 간격으로 조건 확인)
[2025/05/27 18:33:33]
[Okx] 1차진입대기목표수량: 0.03
[2025/05/27 22:08:41]
****** 1차 분할진입조건충족 (매도김프=0.7528) *********
[Okx] 숏 오픈 주문 : 0.03개 → 성공
[빗썸] 시장가 매수 주문 : 0.02977417개 → 성공
진입호가테더 : 1383.57, 진입환율 : 1,372.18
******************************************************
 
 
또한, 진입과 탈출시에는, 동일폴더내에있는  TokenAndID.txt   파일에 본인의 텔레그램 봇토큰과 쳇아이디를 넣게되면,
 

 

본인의 텔레그램에 실시간 진입과 탈출정보를 받을수있게됩니다.

 
이 로그를 통해 자동매매 봇이 언제 어떤 행동을 했는지 추적할 수 있고, 오류 발생 시 원인을 파악하는 데도 도움이 됩니다.
 
만약 네트워크 오류 표시 옵션을 켜두면 API 지연이나 연결 오류 같은 메시지도 로그에 나타납니다.
반대로 로그를 깔끔히 보고 싶다면 이 옵션을 끄면 네트워크 오류 관련 메시지는 생략됩니다.

 
 
실사용 팁: 처음 프로그램을 실행하면 로그에 API 키 연동 성공 여부나 잔고 불러오기 상태 등이 나옵니다.
반드시 로그를 확인해서 API 연결이 정상인지, 잔고가 제대로 표시되는지 확인하세요.
만약 오류 메시지가 반복되면 API 키 설정이나 네트워크 상태를 점검해야 합니다. 
 

간혹 이부분의 환율이 업데이트 되지않으면, 수치가 0으로나옵니다.

 

이럴땐 실시간감시를 중지후, 재실행해주세요 ^^
 

 

오른쪽 패널: 자동매매 조건 설정 영역

오른쪽 패널은 자동매매의 조건을 설정하는 핵심 구역입니다. 김프 기준과 매매 수량, 모드 등을 여기서 지정하게 됩니다.
 
상단에는 김프 매매(단일) 목표 설정이라는 메뉴가 있고, 그 아래 여러 입력 칸과 버튼들이 배치되어 있습니다.
하나씩 살펴보겠습니다.
 

 
① 진입김프: 진입김프는 진입할 김프 기준값을 뜻합니다. 쉽게 말해 김치 프리미엄이 몇 % 이하일 때 거래를 시작할 것
(진입 = 헷징) 인지를 결정하는 값입니다.
 
예를 들어 진입김프를 1%로 설정하면, 매도호가테더가 1% 보다 낮아지는 순간 프로그램이 자동으로 매매에 진입합니다.

(진입 =  국내 현물 매수(*진입김프%) + 해외 숏포지션 오픈)
 

김프 수치는 소수점(4자리)까지 입력 가능하며, 상황에 따라 정밀하게 설정할 수도 있습니다.

• 예시: 진입김프를 1%로 설정한 경우 – 현재 김프가 2~3%일 땐 대기 상태로 있다가, 국내 가격 급등으로 김프가 1%이하가 되는  순간 프로그램이 미리 준비한 대로 해외에서 해당코인을 선물 숏 포지션을 오픈하고, 국내에서 현물 매수하는 거래를 개시합니다.

② 탈출김프: 탈출김프는 탈출(거래 종료)할 김프 기준값입니다. 진입 후에 김프가 이 값까지 올라오면 자동으로 포지션을 청산하여 거래를 마무리합니다.
 
예를 들어 탈출김프를 2%로 설정했다면, 위 사례에서 1%에 진입한 이후 김프가 2% 수준으로 올랐을 때 자동으로 국내에서 코인을 다시 매도(혹은 해외에서 숏포지션 종료(클로즈))하여 처음에 구축했던 햇징을 종료합니다.
이를 통해 시세 차익을 실현하게 되는 것이죠.
 

• 예시: 진입김프 1%, 탈출김프 2% 설정 – 1% 이하 시점에 진입했던 포지션은 김프가 2%가 될 때까지 유지됩니다. 1%→2%로 오르는 동안 국내에서는 싸게산 코인을 더 비싸진 시점에 다시 판매하고, 해외에서는 비싸게 산 코인을 낮은지점에 포지션을 종료 하게 되므로 차익이 확보됩니다.
•  

③ (조정)진입김프 / (조정)탈출김프:
 
이 옵션 값들은 최초 사용자분이 설정한 진입/탈출 값이, 환율의 변동에 의해 자동으로
진입/탈출 조정값으로, 환율이 내려감에따라, 테더 = 김프 값이 (실제 내자산가치)가 내려감을 김프수치가 좀더 높에 포지션을 종료해야 실수익을 볼수있기때문입니다.  
 

 

최초진입시 환율

 

실시간환율 (최초대비 1.3원오름. 1.3 * 0.07 = 0.091% 진입김프가 낮아진효과 환율이 오르면 김프매매에는 도움이된다.

 

기준 환율 값대비, 현재 실시간환율수치를 반영한 (조정)진입수치와 (조정)탈출수치로 김프자동매매가 진행됩니다.

 
 
*** 중요 사항 :   예를들어  환율이 1400원일때, 진입 김프수치가 0.5%라 낮은부분에 진입을 했으나,
              환율이 1390원이 되었다면,  내가 진입한 실김프수치는  1원당 0.07%가 증가되어,   0.5% + 0.7% = 1.2%가 되게됩니다.
 

이수치는 자동으로 보정해준값이 (조정)진입김프 및 (조정)탈출 김프입니다.
이만큼 김프매매는 환율의 움직임에도 많이 민감하다는점을 참고하심좋습니다.

 
 
 
④ 진입요청수량 (BTC): 이 칸은 거래 코인의 진입 주문 수량을 입력하는 곳입니다.
 
쉽게 말해, 조건 충족 시 해당 차수에 또는 단일목표시에는 얼마만큼 진입할것인지,  매수/매도할 코인 양을 정하는 칸입니다.
 
예를 들어 여기에 0.05 BTC라고 넣으면, 진입 조건에 도달했을 때 프로그램이 진입단위 만큼씩 분할하여 진입 또는 탈출하게
됩니다.  옆의 ▲▼ 버튼으로 수량을 내가설정한 진입단위만큼씩 증감시킬 수도 있습니다.
 
실시간 감시시작을 하기전에,  미리 설정을 하고 봇을 실행하도록 되어있습니다. (중간에 변경불가옵션)
 
팁! : 분할로 1~5차까지 진입을 한상황이고,  진입평균김프가 1%가되었다면,  분할자동매매를 중지후 (또는 단일자동매매를중지후)
        5차부터 > 4차까지 모두 사용안함으로변경후,  1차수량에 내가 진입한 숏 포지션수량 (예.0.5개)를 모두넣고 진입률을
        수동으로, 100%로 올려 1번에 모두 탈출시키게 대응이 가능합니다.
 
     

하단에있는, 화살표 위/아래 버튼은 선택된 차수의 수량 대비 진입단위만큼 진입율을 수동으로 올리고 내릴수있음.

 

• 초보자 팁:  진입단위를 조정하는것은, 큰금액으로 시장가주문시에  내가원하는 금액호가에 물량이없을시에는, 더높은금액에체결되는현상 (슬리피지) 발생을 최소화 하여 진행하고자함입니다.     

3차에 진입수량은 0.06개로 설정했지만, 진입단위가 0.005로, 해당 (조정)진입값에 도달시 12번의 주문이 분할되어 진입이됩니다.

 
 
 
⑤ 진입률 (%): 진입률은 각 분할 차수별 진입율의 상태를 표시합니다.
 
 
⑥ S / B / U 버튼의 의미:  진입평균테더 값 및 진입평균김프수치에대한, (초기화 / 백업 / 복원 기능)
   
    백업시 동일폴더내 ave.txt 파일내에 저장됩니다. 
   (대략 이수치를 기억하게되면, 추후 갑작스러운 프로그램종료 또는 재실행시 재설정에 유용합니다.)
 
   (또한, 내가 진입한 분할 예를들어, 1~3차까지 진입한 평균김프테더 수치와, 평균김프%를 알게되면, 대략 저지점에서 높아지면
    모두 즉시탈출해도 되겠구나. 라는걸 알수있게됩니다.)
 

환율연동을 체크하면, 진입평균김프수치 또한 환율변동에 의해 변화가 됩니다.

 
 

⑦ DCA (분할 매매) 옵션: DCA는 Dollar Cost Averaging의 약자로, 원래는  분할 매매로, 꾸준하게 모아간다는 의미입니다.
 
    제봇을 처음 열었을때, 김프매매봇인데 DCA ? 이게 뭐지 라고 생각하시는분들이 참 많을꺼같습니다.
 
    사족으로, 오랜시간동한, 김프매매를 하다보니 항상 보면. 
 
    기본적으로 해외거래소와 국내거래소의 차이를 이용한 매매방식입니다만, 대부분 국내거래소의 비트코인금액은 변화가
    별로없으나,  해외거래소에서 (미국장이 시작되는시간 또는, CPI 발표등의 이슈)로 인해서, 비트코인의 급락이 일어나는 경우
    김프(차이가)가 순식간에 벌어지며, 탈출하는 경우가 많습니다.
 
    그래서 해외거래소의 SHORT 포지션을 구축한타점을 살펴보면, 항상 너무나도 예술적인 지점들에서 종료가 되곤하게됩니다.
 
 

비트코인 숏포지션을 종료함과 동시에,

내가 설정한 SPOT 현물을 매수하는 기능.

 
 
     이부분에서 착안을 하여 해당 기능을 추가하였습니다.
 
    김프를 탈출하게되면, 대부분  1% 진입 -> 2%에 탈출을 하게될것이며,  해외보다 국내가 비싼시점일것입니다.
    그시점에 해외거래소에서 현물 SPOT 코인을 매수한다면, 그지점이 최대 하락폭지점인 경우도 높기도하며,  올라가거나
    내려가는 추세에서도 항상 저점인 경우가 많습니다.
 
    기왕 모으고 싶은코인이 있는데,  김프수익금중 일부테더로, 항상 저점일때에 모으는 효과를 보자는 취지로 만들어보았습니다.^^
 
    필요가없다면 UI 우측에

 
   DCA 체크버튼을 끄고 -> 실시간조회시작을 하게되면, 모으지 않게되며,  좌측 패널에서 잔고조회도 이루어지지 않습니다.
 
   만약 실행하고 싶으실때에는 해당 DCA 버튼을 체크를 하고 -> 실시간조회 시작
 

모으고싶은 코인명과 구매단위(USDT)를 선택

 

UI에 내가 설정한 코인과 구매단위가 자동으로 변동되어 상태를 확인

 
   
 응용방법 :  예를들어 SOL (솔라나) 코인을 모으게되면, 바이비트 또는 OKX는  SOL 코인을 BBSOL (바이비트) / OKSOL (OKX) 
                  로 각 거래소는 솔라나를 예치할수있으며,  해당코인으로 이자율이 5~8%이내로 코인으로 받을수도있습니다.
                  (국내 빗썸거래소 자율스테이킹 1.2% / 고정스테이킹 2.3%  대비 훨씬더 좋은 부분이지요)
 
 

파트 1부분은 이쯤에서 마치고.
 
파트 2부분에서는, 단일 자동매매설정 및 분할자동매매 / 자산증감과 뉴스설정에 대해 알아보도록하겠습니다.
 
함께 김프매매로 경제적 자유 누립시다^^
 
 
김프자동매매 프로그램 받으러가기!
https://allmusicstory.tistory.com/116

 
 
 
 

* 모든 투자에 대한 책임은 투자자 본인에게 있습니다.