처음 봇을 시작하시는 분도
차근차근 따라하면 됩니다
OnStock Bot은 두 개의 월배당 ETF를 자동으로 바꿔타며 매매해주는 도구입니다. 이 매뉴얼은 컴퓨터를 잘 다루지 않으셔도 누구나 따라할 수 있도록 만들었습니다. 한 단계씩 천천히 진행해 주세요.
🤖 OnStock Bot이란?
OnStock Bot은 한국투자증권 계좌에 연결해서 월배당 ETF 두 종목을 24시간 자동으로 사고팔아 주는 매매 도우미입니다. 사용자가 시세를 보면서 직접 주문을 넣지 않아도 됩니다. 봇이 알아서 매수·매도 주문을 넣고, 결과를 텔레그램과 앱 알림으로 알려줍니다.
가장 큰 특징은 두 종목을 배당락일(배당을 받는 날) 전에 자동으로 바꿔타는 기능입니다. 이렇게 하면 두 종목의 배당 일정을 합쳐 한 달에 여러 번 배당을 받는 효과를 노릴 수 있습니다.
- 월배당 ETF로 꾸준한 현금흐름을 만들고 싶은 분
- 매일 차트를 들여다볼 시간이 없는 분
- 장기 보유보다는 변동성을 활용한 자동매매에 관심 있는 분
🔑 "API 키"가 뭔가요?
API 키는 봇이 내 계좌에 들어와서 주문을 넣을 수 있도록 해주는 전용 비밀번호라고 생각하시면 됩니다. 평소 쓰는 로그인 비밀번호와는 다른, 봇 전용 비밀번호이며 두 개의 문자열(App Key, App Secret)로 이루어져 있습니다.
한국투자증권 개발자센터 접속
인터넷 주소창에 apiportal.koreainvestment.com 을 입력하거나 "한국투자증권 API 포털"을 검색해서 접속합니다.
상단의 "API 신청" 메뉴를 클릭합니다.
로그인 및 본인 인증
평소 한국투자증권에서 사용하시던 홈페이지 로그인 정보로 들어갑니다. 공동인증서(예전 공인인증서)나 휴대폰 인증을 요구할 수 있습니다.
"실전 모의투자 신청" 선택
API 신청 페이지에서 "실전투자"를 선택합니다. 모의투자는 봇이 동작은 하지만 실제 돈으로 거래되지 않습니다. 실전 사용 전에 한 번 모의로 테스트해보는 것도 좋습니다.
계좌 선택 및 약관 동의
내 계좌 중 봇으로 운용할 계좌를 골라 선택합니다. 그리고 약관(개인정보, 서비스 이용)을 읽고 동의에 체크합니다.
App Key와 App Secret 받기
신청이 완료되면 두 줄의 긴 문자가 나타납니다. 이것이 봇에 입력할 전용 비밀번호입니다.
두 줄을 안전한 곳에 복사해 두기
나중에 봇 설정 화면에 입력해야 합니다. 지금은 메모장이나 휴대폰 잠긴 메모에 두 줄을 그대로 복사해 두세요. 띄어쓰기 한 칸이라도 잘못 들어가면 작동하지 않습니다.
📨 봇 주소가 어디 있나요?
OnStock Bot은 운영자가 미리 모든 준비를 마쳐 둔 상태로 제공됩니다. 따로 프로그램을 설치하거나 복잡한 설정을 하실 필요가 없습니다. 아래 주소를 클릭하시거나 주소창에 입력하시면 바로 봇 화면으로 들어갈 수 있습니다.
이 주소는 외우기 쉬운 단축 주소입니다. 즐겨찾기에 등록하거나 휴대폰 홈 화면에 추가해 두시면 앞으로 봇을 켜고 끌 때마다 한 번의 클릭으로 접속할 수 있습니다.
안드로이드 — 크롬 브라우저에서 주소 접속 후 우측 상단 ⋮ 메뉴 → "홈 화면에 추가"
앱처럼 한 번의 터치로 봇을 열 수 있어 편리합니다.
🚀 전체 흐름 한눈에 보기
봇 주소로 접속하기
브라우저 주소창에 https://stockon.short.gy 를 입력하거나 위 카드의 링크를 클릭합니다. 처음 들어가면 아래와 같은 화면이 보입니다.
- 다른 구글 ID로 들어가시면 화면이 빈 상태로 보이고 기존 데이터가 나타나지 않습니다.
- 이는 데이터가 사라진 것이 아니라, 다른 계정에서 접근 중이라 보이지 않는 것입니다.
- 가입 시 사용한 ID로 다시 로그인하시면 기존 설정이 그대로 나타납니다.
무료 가입 신청
"무료 가입" 버튼을 누르면 운영자에게 가입 요청이 전송됩니다. 운영자가 승인해주기 전까지는 매매가 시작되지 않습니다. 보통 빠르면 몇 분, 늦어도 하루 안에 처리됩니다.
- 지금: 모든 기능 완전 무료로 제공
- 앞으로: 화면 광고 표시 또는 기부 항목이 추가될 수 있음 (선택 사항)
- 강제 결제·유료 전환은 계획에 없습니다. 안심하고 이용하셔도 됩니다.
⚙ 설정 화면 열기
화면 위쪽 ⚙ 설정 버튼을 누르면 설정 창이 열립니다. 여기서 봇에 알려줄 정보를 차례대로 입력합니다.
설정값 입력 안내
각 항목은 다음과 같이 채워주세요.
- 거래 모드: 처음에는 월배당 갈아타기 그리드 매매가 무난합니다. (모드 설명은 다음 단원 참고)
- 계좌번호: 한국투자증권에서 사용하는 내 계좌번호 앞 8자리만 입력 (예: 한투 화면에 50012345-01로 표시되면 봇에는 50012345만 입력)
- App Key / App Secret: 한국투자증권 API 포털에서 받은 두 줄을 그대로 붙여넣기
- 진입금액: 봇이 한 번에 매수할 금액 (예: 10000000 = 1천만원)
- 수익청산 (%): 이만큼 이익이 나면 자동으로 팔기 (예: 2 = 2%)
- 최대갭 / 최소갭: 매수·매도 가격을 얼마나 멀리 둘지 정하는 값 (기본값 그대로 두기 권장)
종목 두 개 등록
설정창을 닫고 메인 화면으로 돌아가면 월중 / 월말 두 칸이 있습니다. 각 칸에 종목 이름과 종목번호 6자리를 입력하고 💾 버튼으로 저장합니다.
알림 받을 채널 연결 (선택)
매수·매도 알림을 텔레그램으로 받고 싶으시면 화면 위 "텔레그램 알림" 버튼을 누릅니다. 자동으로 텔레그램 앱이 열리고, "시작" 버튼만 누르면 연결이 완료됩니다.
안드로이드 휴대폰을 쓰시면 별도의 OnStock Bot 앱(APK)도 설치할 수 있습니다. 앱 알림은 더 빠르고 별도 표시가 됩니다.
▶ 봇 시작!
모든 준비가 끝났으면 화면 위 ▶ 시작 버튼을 누릅니다. 버튼이 빨간색 ■ 정지로 바뀌고, 우측 상단 표시등이 초록색으로 깜빡이면 봇이 가동 중입니다.
🖥️ 메인 화면 구성
OnStock Bot 화면은 크게 다섯 가지 영역으로 나뉩니다.
📋 종목 카드 안의 항목 풀이
- 현재가 — 지금 시장에서 거래되는 1주 가격
- 보유수량 — 내가 가진 주식 수
- 보유수익률 — "한투" 값은 한국투자증권 기준, "진입" 값은 봇 기준 수익률
- 진입가격 / 진입수량 — 봇이 처음 들어간 가격과 수량 (수동으로도 입력 가능)
- 이전수익률 — 갈아타기 전 종목에서 가져온 누적 수익률
- 매수주문 / 매도주문 — 지금 시장에 걸려있는 봇의 예약 주문
- 배당마감일 — 이 종목을 배당받기 위해 들고 있어야 하는 마지막 날짜
- 갭 ×100% — 봇이 다음 매매 가격을 얼마나 띄울지 결정하는 값
- 괴리율 % — ETF 가격과 실제 자산가치(NAV) 사이의 차이
🎬 화면 위 버튼들
- ▶ 시작 / ■ 정지 — 봇 가동/중지
- ⇄ 갈아타기 — 지금 들고 있는 종목을 즉시 다른 종목으로 바꿉니다 (수동 갈아타기)
- ⚙ 설정 — 계좌, API 키, 거래 조건 변경
- ↑ 진입 — 종목 카드의 매수 버튼 (수동으로 즉시 매수)
- ↓ 청산 — 종목 카드의 매도 버튼 (수동으로 즉시 전부 매도)
- ↻ 새로고침 — 화면 데이터를 다시 불러오기
- 로그아웃 — 봇 화면에서 빠져나가기 (봇은 계속 돌아갑니다)
📊 한눈에 비교하기
각 모드가 어떤 기능을 사용하는지 표로 정리했습니다.
| # | 이름 | 갈아타기 | 그리드 | NAV 활용 | 헷지 |
|---|---|---|---|---|---|
| 0 | 월배당 갈아타기 그리드 | ✓ | ✓ | — | — |
| 1 | 월중 종목만 그리드 | — | ✓ | — | — |
| 2 | 월말 종목만 그리드 | — | ✓ | — | — |
| 3 | 두 종목 모두 그리드 | — | ✓ | — | — |
| 4 | 월배당 NAV 갈아타기 그리드 | ✓ | ✓ | ✓ | — |
| 5 | 무배당 NAV 갈아타기 그리드 | ✓ | ✓ | ✓ | — |
| 6 | NAV 갭 헷징 인버스 | — | — | ✓ | ✓ |
| 7 | NAV 갭 헷징 인버스 그리드 | — | ✓ | ✓ | ✓ |
📚 용어 풀이
그리드 매매 — 격자(grid)처럼 일정한 가격 간격을 두고 매수·매도를 반복하는 방식입니다. 예를 들어 가격이 10,000원일 때 9,950원에 매수, 10,050원에 매도 주문을 동시에 걸어두는 식입니다. 어느 한쪽이 체결되면 다시 새 가격을 기준으로 주문이 갱신되어 시세가 오르내릴수록 차익이 쌓입니다.
갈아타기 (스왑) — 한 종목을 모두 팔고 그 돈으로 다른 종목을 사는 동작입니다. OnStock Bot은 월배당 종목의 배당락일(배당받을 권리가 사라지는 날) 전에 자동으로 갈아타서 두 종목 모두에서 배당을 챙길 수 있도록 합니다.
NAV (순자산가치) — ETF가 실제로 들고 있는 자산의 가치입니다. 시장에서 거래되는 가격과 NAV 사이의 차이를 괴리율이라고 하며, 이 값을 활용해 매매 타이밍을 잡을 수 있습니다.
헷지(헷징) — 가격이 오를 종목과 내릴 종목을 동시에 들어서 시장 전체가 어느 쪽으로 가든 손실을 줄이는 전략입니다.
⚙️ 추가 옵션
- 수익중 2배 수량 주문 (레버리지) — 수익이 나는 동안 매매 수량을 2배로 늘립니다. 빠르게 수익을 키울 수 있지만 위험도 커집니다.
- 손실중 2배 수량 주문 (인버스) — 손실 구간에서 수량을 2배로 늘려 회복을 노립니다. 손실 폭이 커질 수 있어 주의가 필요합니다.
- 앱 알림 ON/OFF — 스마트폰 앱으로 매매 알림을 받을지 정합니다.
- 텔레그램 알림 ON/OFF — 텔레그램으로 매매 알림을 받을지 정합니다.
📦 가장 중요 — 봇 시작 전 두 종목을 1주씩 미리 매수해 두세요
거래 모드 0 · 4 · 5 · 6 · 7처럼 갈아타기 기능을 사용하는 모드를 쓰시려면, 봇을 처음 켜기 전에 월중·월말 종목을 각각 1주씩 한국투자증권 앱에서 직접 매수해 두셔야 합니다. 이 1주는 봇이 매매하는 도중에도 계속 남아 있어야 합니다.
-
① 내가 얼마에 들어갔는지(진입 가격)를 기억하기 위해서
갈아타기로 보유 수량이 0이 되면, 한국투자증권에서는 그 종목의 평균 매수단가를 더 이상 보여주지 않습니다. 나중에 다시 그 종목으로 돌아왔을 때 "내가 원래 얼마에 들어갔는지"를 비교할 수 없게 되어 정확한 수익률 계산이 어려워집니다. 1주만 남겨두면 평균 매수단가가 그대로 유지되어, 청산 후 다시 진입했을 때도 정확한 수익을 따질 수 있습니다. -
② 봇이 증권사에 보내는 신호 횟수를 줄이기 위해서
한국투자증권은 하루에 사용할 수 있는 통신 횟수에 한도가 있습니다. 보유 수량이 0이면 봇이 매번 추가로 "지금 가격이 얼마지?", "보유는 그대로지?" 같은 확인을 더 자주 해야 합니다. 1주를 들고 있으면 봇이 꼭 필요한 통신만 간결하게 처리할 수 있어, 하루 한도 안에서 안정적으로 작동합니다.
🛠 처음 시작할 때 이렇게 준비하세요
한국투자증권 앱(또는 HTS) 접속
평소처럼 한국투자증권 앱에 로그인하고 주식 매수 화면을 엽니다.
월중 종목 1주 매수
봇에 등록할 월중 종목을 검색해서 딱 1주만 시장가로 매수합니다.
월말 종목 1주 매수
봇에 등록할 월말 종목도 마찬가지로 1주만 시장가로 매수합니다.
보유 확인 후 봇 ▶ 시작
두 종목 모두 "보유수량 1주 이상"인지 확인한 다음 봇 화면에서 시작 버튼을 누릅니다.
참고 — 거래 모드 1·2·3(갈아타기 안 쓰는 모드)에서는 1주 보유가 필수는 아니지만, 그래도 진입가 확인과 통신 절약 효과는 동일하므로 모든 모드에서 1주는 미리 매수해 두시는 것을 권장합니다.
Q. 봇을 사용하는 데 정말 무료인가요?
Q. 내 컴퓨터를 24시간 켜두어야 하나요?
Q. 최소 얼마부터 시작할 수 있나요?
Q. 다른 사람도 내 봇 주소로 들어가면 내 돈이 위험한가요?
Q. 봇이 갑자기 멈췄어요. 어떻게 하나요?
- 화면 아래 실시간 로그에 빨간색 오류 메시지가 있는지 본다
- 설정 창을 열어 토큰 발급일이 오늘 날짜인지 확인
- 1년 가까이 사용했다면 한국투자증권에서 키가 만료됐을 수 있음 (재발급 필요)
- 예수금이 충분한지 한국투자증권 앱에서 확인
- 그래도 안 되면 텔레그램 채널로 문의
Q. 거래 모드를 도중에 바꿔도 되나요?
Q. 봇이 매도만 하고 매수를 안 해요
Q. 갈아타기 후에 손실이 생기면 어떻게 되나요?
Q. 두 종목을 다른 ETF로 바꿔도 되나요?
Q. 봇을 잠시 쉬게 하고 싶어요
Q. 봇이 한 번에 너무 많이 사면 어떻게 하나요?
Q. 알림이 너무 많이 오는데 줄일 수 있나요?
이제 자동매매의 세계로
한 걸음 들어가 보세요
궁금한 점이 생기면 언제든 텔레그램 채널이나 이메일로 문의해 주세요. 매뉴얼은 계속 업데이트되니 주기적으로 다시 한 번 읽어보시는 것도 좋습니다.