깃허브에서 “trading bot”을 검색하면 별 3만 개를 넘긴 저장소가 줄줄이 나옵니다. 그런데 상단을 차지한 프로젝트 대부분은 암호화폐 거래소 API를 전제로 만들어졌어요. 한국 주식 계좌에 그대로 붙는 물건은 아닙니다. AI 주식 자동매매 오픈소스를 찾는 분이 가장 먼저 부딪히는 벽이 여기예요. 코드를 받아 도커로 띄우는 데까지는 30분이면 충분한데, 그 봇이 국내 증권 계좌에 주문을 넣으려면 증권사 오픈API를 따로 연동해야 합니다.
결론부터 말하면, 깃허브 상위권 자동매매 오픈소스는 국내 주식에 바로 쓸 수 있는 완제품이 아니라 전략을 대신 실행해 주는 뼈대입니다. 국내 계좌에 붙이려면 한국투자증권 같은 증권사의 오픈API를 별도로 연동해야 하고, 저장소에 적힌 수익률은 대부분 백테스트·모의투자 결과라 실계좌 성과와 다릅니다. 개인이 자기 계좌에서 본인 자금을 굴리는 건 인가 대상이 아니지만, 타인 자금 운용이나 신호 판매로 넘어가는 순간 자본시장법 문제가 생깁니다.
사진 출처: biz.chosun.com
목차
- 한눈에 보기
- 깃허브 상위권 자동매매 봇은 실제로 뭘 하는 물건일까?
- 여기서 말하는 ‘AI’는 어느 수준일까?
- 공개된 수익률 수치는 믿어도 될까?
- 한국에서 돌리면 불법인가요?
- 돌리는 데 실제로 얼마나 들까?
- 시작 전 체크리스트
한눈에 보기
- 깃허브 스타 상위권 자동매매 봇은 대부분 암호화폐 거래소 API 기반이며, 국내 주식을 거래하려면 한국투자증권 등 증권사가 제공하는 오픈API를 별도로 붙여야 합니다.
- 저장소 문서에 적힌 수익률은 대체로 백테스트나 모의투자 결과이고, 수수료·슬리피지·체결 지연이 반영된 실계좌 성과와는 다릅니다.
- 개인이 자기 계좌에서 본인 자산을 자동매매하는 행위는 원칙적으로 규제 대상이 아니지만, 타인의 자금을 굴리거나 매매신호를 유료로 파는 순간 자본시장법상 인가·등록 문제가 따라붙습니다.
깃허브 상위권 자동매매 봇은 실제로 뭘 하는 물건일까?
깃허브 상위권 자동매매 봇은 종목을 골라주는 AI가 아니라 사용자가 짜 넣은 전략을 실행해 주는 뼈대입니다. 매수·매도 조건은 사용자가 파이썬으로 직접 써 넣어야 돌아가요. 자주 언급되는 프로젝트를 성격별로 나눠보면 이렇습니다.
| 성격 | 대표적인 형태 | 주 대상 시장 | 국내 주식 연동 |
|---|---|---|---|
| 전략 실행 봇 | Freqtrade 계열 (파이썬, 도커 배포) | 암호화폐 현물·선물 | 기본 미지원 |
| 백테스트 엔진 | Backtrader, vectorbt 등 | 시장 무관, 데이터만 넣으면 됨 | 데이터 준비하면 가능 |
| 강화학습 프레임워크 | FinRL 계열 | 미국 주식·코인 연구용 | 연구 목적 위주 |
| 증권사 API 래퍼 | 한국투자증권 오픈API 파이썬 래퍼류 | 국내 주식 | 목적 자체가 국내 연동 |
‘깃허브 1위’라는 표현은 보통 특정 토픽 태그 안의 스타 수 순위를 뜻합니다. 스타는 인기 지표이지 수익성 지표가 아니에요. 별이 많다고 해서 그 전략이 돈을 벌었다는 근거는 되지 않습니다. 오히려 스타가 몰린 저장소는 문서와 커뮤니티가 두텁다는 뜻이라, 초보자가 삽질을 덜 한다는 쪽으로 해석하는 게 정확합니다.
여기서 말하는 ‘AI’는 어느 수준일까?
여기서 말하는 ‘AI’는 대부분 머신러닝이 아니라 규칙 기반 자동화입니다. 이동평균 교차, RSI 과매도 같은 기술적 지표 조건을 코드로 적어두면 그대로 주문을 냅니다. 머신러닝은 선택 모듈로 붙는 구조예요. Freqtrade의 FreqAI처럼 지표를 피처로 삼아 예측 모델을 학습시키는 확장 기능이 대표적입니다.
LLM이 뉴스를 읽고 스스로 판단해 매매하는 형태는 아직 실험·연구 단계 프로젝트가 많아요. 데모 영상은 그럴듯한데 실계좌에 붙이기엔 이르다고 봅니다.
공개된 수익률 수치는 믿어도 될까?
공개된 백테스트 수익률은 그대로 믿을 수 없습니다. 과거 데이터에 파라미터를 이리저리 맞추다 보면 그 기간에만 잘 맞는 숫자가 나오기 때문이에요. 이걸 과최적화(overfitting)라고 부릅니다.
수치를 볼 때 확인하면 좋은 항목입니다.
- 검증 기간: 상승장만 담긴 1년치인지, 하락장을 포함한 3년 이상인지
- 총 거래 횟수: 20~30회 표본으로는 통계적 의미를 말하기 어렵습니다
- MDD(최대 낙폭): 연 40% 수익이어도 중간에 -50%를 겪었다면 실제로는 버티기 힘든 전략입니다
- 수수료·슬리피지 반영 여부: 하루 수십 번 거래하는 전략은 이 항목 하나로 흑자가 적자로 뒤집힙니다
- 워크포워드 검증: 학습 구간과 검증 구간을 나눠 돌렸는지
커뮤니티 후기도 표본이 한쪽으로 기울어 있어요. 손실을 본 사람은 조용히 봇을 끄고 사라지고, 성과가 좋았던 사람만 캡처를 올리거든요. 후기 개수가 많다고 승률이 높은 게 아닙니다.
한국에서 돌리면 불법인가요?
개인이 자기 명의 계좌에서 본인 자금을 자동으로 매매하는 것은 불법이 아니며 인가 대상도 아닙니다. 선이 갈리는 지점은 세 가지예요.
- 타인의 자금·계좌 운용: 남의 돈을 대신 굴리면 자본시장법상 투자일임업 인가 문제가 생깁니다. 지인 계좌를 호의로 대신 돌려주는 것도 구조는 같습니다.
- 매매신호 판매·유료 리딩: 봇의 신호를 유료로 제공하면 유사투자자문업 신고나 투자자문업 등록 여부가 따라옵니다. 관련 조문은 국가법령정보센터에서 자본시장과 금융투자업에 관한 법률로 찾아보실 수 있어요.
- 주문 패턴 자체의 문제: 체결 의사 없는 대량 호가를 넣었다 취소하는 허수성 주문은 시장질서 교란행위로 다뤄질 수 있습니다. 봇이 초 단위로 주문·취소를 반복하는 설계라면 미리 점검해 두는 편이 안전합니다.
사진 출처: thumb.mt.co.kr
증권사 오픈API 이용약관에도 제한이 걸려 있습니다. 초당 호출 횟수, 계정당 세션 수, 자동주문 허용 범위가 약관과 개발자센터 문서에 명시돼 있어요. 약관 위반은 법 위반과는 별개지만 API 이용 중단 사유가 됩니다. 신청하기 전에 해당 증권사 개발자센터 문서를 한 번 훑어보시길 권합니다.
암호화폐 쪽은 2024년 7월 시행된 가상자산이용자보호법 이후 시세조종·미공개정보 이용에 대한 규제 틀이 잡혔습니다. 개인의 자동매매가 곧바로 금지되는 건 아니에요. 다만 자기 물량을 자기가 받는 자전거래성 주문 설계는 피하는 게 좋습니다.
돌리는 데 실제로 얼마나 들까?
오픈소스 자체는 무료이고, 실제 비용은 인프라와 데이터, 거래 수수료에서 나갑니다.
- 서버: 해외 VPS 기준 월 5~10달러대 사양이면 봇 하나는 충분합니다. 집 PC나 라즈베리파이로 돌리는 사람도 많아요.
- 증권사 오픈API: 국내 주요 증권사는 대체로 무료로 제공하지만 계좌 개설과 신청 절차를 거쳐야 합니다.
- 시세 데이터: 실시간 시세는 증권사 API로 받되, 과거 데이터를 대량으로 쓰려면 유료 벤더를 고려하게 됩니다.
- 거래 비용: 국내 주식은 매도할 때마다 증권거래세와 증권사 수수료가 빠집니다. 회전율이 높은 전략일수록 이 항목이 수익률을 갉아먹어요.
국내 주식 자동매매에는 현실적인 제약도 붙습니다. 장 시간이 평일 오전 9시~오후 3시 30분으로 묶여 있어 24시간 돌아가는 코인 봇과 리듬이 완전히 달라요. 일부 구형 API는 윈도우 환경과 32비트 파이썬에 종속돼 있어 리눅스 서버 배포가 까다롭습니다. REST 방식 오픈API를 제공하는 증권사를 고르면 이 문제는 상당히 줄어듭니다.
시작 전 체크리스트
실계좌를 붙이기 전에 반드시 확인해야 할 항목은 여섯 가지입니다.
- 페이퍼 트레이딩(모의투자)으로 최소 1~2개월은 돌려보고 백테스트 결과와 비교하기
- 실계좌 투입은 잃어도 생활에 지장 없는 소액부터
- 일일 손실 한도와 킬 스위치(자동 정지) 로직을 코드에 먼저 넣기
- API 키는 거래 권한만 부여하고 출금 권한은 비활성화, 키는 환경변수로 분리
- 백테스트에 수수료·세금·슬리피지가 들어갔는지 재확인
- 해외 거래소나 해외 주식을 다룬다면 소득 신고 의무 확인
오픈소스 봇은 수익 기계가 아니라 전략 실행 도구입니다. 좋은 도구를 얻었다는 게 좋은 전략을 얻었다는 뜻은 아니에요. 성패를 가르는 건 어떤 저장소를 골랐느냐가 아니라 그 안에 무엇을 써 넣느냐입니다. 국내 증권사들이 REST 기반 API를 넓혀가는 흐름은 반갑고, 앞으로 1~2년 안에 한국 주식용 오픈소스 생태계가 지금보다는 두터워질 거라 봅니다.
핵심 정리
AI 주식 자동매매 오픈소스의 요점은 다음 다섯 가지입니다.
- 정체: 깃허브 스타 상위권 봇은 종목을 골라주는 AI가 아니라 규칙 기반 전략 실행 뼈대이고, 매수·매도 조건은 사용자가 파이썬으로 직접 작성해야 합니다.
- 연동: 상위권 저장소는 암호화폐 거래소 API를 전제로 하므로, 국내 주식은 한국투자증권 등 증권사 오픈API를 별도로 붙여야 합니다. REST 방식을 제공하는 증권사를 고르면 32비트 파이썬·윈도우 종속 문제를 줄일 수 있습니다.
- 수익률: 공개 수치는 대부분 백테스트·모의투자 결과입니다. 검증 기간, 총 거래 횟수, MDD, 수수료·슬리피지 반영 여부, 워크포워드 검증 다섯 가지를 확인하세요.
- 법: 자기 계좌·자기 자금 자동매매는 인가 대상이 아니지만, 타인 자금 운용은 투자일임업, 신호 유료 판매는 유사투자자문업·투자자문업 문제로 이어집니다. 허수성 주문은 시장질서 교란행위가 될 수 있고, 암호화폐는 2024년 7월 시행된 가상자산이용자보호법의 적용을 받습니다.
- 비용과 제약: 오픈소스는 무료지만 VPS 월 5~10달러대, 과거 시세 데이터, 증권거래세와 수수료가 듭니다. 국내 장 시간은 평일 오전 9시~오후 3시 30분으로 24시간 코인 봇과 운영 리듬이 다릅니다.
혹시 백테스트에서는 잘 나왔는데 실계좌에서 무너진 경험이 있으신가요? 어느 지점에서 차이가 벌어졌는지 댓글로 나눠 주시면 서로 도움이 될 것 같습니다.