파이썬 주식·ETF 자동매매 구조

기본 흐름

전략 / 목표비중
      ↓
백테스트
      ↓
증권사 API 인증
      ↓
잔고·보유종목·현재가 조회
      ↓
목표비중 vs 현재비중
      ↓
리밸런싱 수량 계산
      ↓
매도 → 매수 주문

현재 다루는 증권사

현재 한국투자증권, LS증권, 키움증권, 토스증권, KB증권, NH투자증권, 메리츠증권, DB증권을 다룹니다. 지원사가 추가되어도 메뉴 이름은 숫자에 묶이지 않도록 멀티 증권사 API로 운영합니다.

멀티 증권사 Open API 비교 →

전략 코드와 증권사 코드를 분리합니다

전략이 증권사의 원본 응답형식을 직접 알게 만들기보다, 각 증권사 Adapter/Common·Helper가 잔고·현재가·보유종목·주문을 공통 형태로 변환하도록 설계하면 동일 전략을 여러 환경으로 옮기기 쉬워집니다.

새 증권사를 추가할 때도 전략 파일 전체를 다시 작성하는 대신, 기존 공통 함수 규격을 만족하는 모듈을 추가하는 방향으로 확장할 수 있습니다.

공통모듈은 필요한 기능을 공통화한 실전용 레이어입니다

게만아의 증권사 공통모듈은 각 증권사 API 전체를 똑같이 복제하는 것이 목적이 아닙니다. 실제 전략에서 반복해서 사용하는 인증, 잔고, 보유종목, 시세, 주문 등의 기능을 공통 형태로 만들어 전략 코드가 증권사별 차이를 덜 신경 쓰도록 하는 구조입니다.

Starter는 이 구조의 입문용 최소 범위이며, 정식 콘텐츠인 통합 패키지와 그 안에 포함된 슈퍼 이동평균 V2를 실제로 운용하는 데 필요한 핵심 API 기능이 이미 구현되어 있습니다. 일반적인 사용이라면 증권사 공식 문서를 보고 함수를 새로 만들 필요는 없습니다. 개인적으로 새로운 API 기능이 필요할 때만 공식 문서를 기준으로 추가 확장하면 됩니다.

또한 AI 확장은 공통모듈에만 한정되지 않습니다. 전략·백테스트·자동매매 봇·보조시스템까지 기존 코드를 바탕으로 수정·확장할 수 있습니다.

게만아 전체 코드 AI 확장 가이드 → · 전체 아키텍처 보기 →

증권사 API가 불안정할 때의 대응도 공통모듈에 들어 있습니다

증권사 API는 올바른 요청에도 일시적으로 오류를 내거나 응답하지 않을 수 있습니다. 게만아 공통모듈은 호출 간 대기, 응답 대기 제한, 호출 제한 시 대기 후 재시도, 토큰 재발급 같은 대응을 모든 증권사가 함께 쓰는 공용 API 호출 계층에 넣어, 증권사마다 다른 응답 코드도 공통 기준으로 처리하므로 전략 코드가 신경 쓰지 않아도 됩니다. 자세히 보기 →