1. FreeTrader는 어떤 프로그램인가요?

FreeTrader는 한국투자증권 계좌에 연결해서 분할매수 전략을 자동으로 실행해주는 PC 프로그램입니다. 사람이 매일 HTS를 켜고 직접 주문을 넣는 대신, 정해둔 규칙대로 프로그램이 알아서 사고팝니다.

작동 4단계

2. 시작 전 준비물 (계좌 · API 키)

FreeTrader는 한국투자증권 KIS Open API로 계좌에 접속합니다. 아래 3가지가 준비되어야 합니다.

실전투자 계좌 준비

1. 한국투자증권 계좌 개설 — 이미 있으면 건너뜁니다. 없다면 '한국투자' 앱이나 홈페이지에서 신분증 촬영만으로 비대면 개설이 가능합니다.
2. KIS Developers 가입 — apiportal.koreainvestment.com에 접속해 한국투자증권 계정으로 회원가입합니다.
3. API 신청 — 로그인 후 상단 API신청 메뉴에서 실전 계좌번호를 선택하고 신청합니다. 본인 인증을 완료하면 신청이 끝납니다.
4. 키 확인 — 신청정보 화면의 신청현황 표에서 App Key와 App Secret을 복사해둡니다.

모의투자 계좌 준비 (강력 추천)

실제 돈을 넣기 전에 모의투자로 며칠 돌려보시길 권장합니다. 설정이 의도대로 동작하는지 확인할 수 있습니다.

1. 한국투자증권 앱/홈페이지의 모의투자 메뉴에서 모의투자를 신청하면 모의계좌번호가 발급됩니다.
2. KIS Developers에서 그 모의계좌번호로 API를 한 번 더 신청합니다.
3. 모의투자용 App Key / App Secret은 실전용과 다르게 발급됩니다. 따로 보관하세요.

3. 프로그램 처음 실행하기

① 면책조항 동의

프로그램을 처음 실행하면 면책조항 확인 창이 뜹니다. 내용을 끝까지 읽고 아래 체크박스에 체크한 뒤 동의하고 계속을 누르세요.

② 라이선스 인증

다음으로 라이선스 키를 입력하는 창이 나타납니다. 구매하셨다면 발급받은 키를 붙여넣고 인증 확인을 누르면 됩니다.

③ 7일 무료 체험 받기 (처음이신 경우)

아직 구매 전이라면 🎁 처음이신가요? 7일 무료 체험 문구를 클릭하세요. 입력란이 펼쳐집니다.

아래처럼 정보를 채우고 🎁 7일 무료 체험 발급받기 버튼을 누르면, 라이선스 키가 위쪽 입력창에 자동으로 채워집니다. 그대로 인증하시면 바로 사용할 수 있습니다.

4. 화면 둘러보기 — 5개의 탭

인증이 끝나면 메인 화면이 열립니다. 화면은 매매현황 · 설정 · 결과 · 종목 · 사용안내 5개의 탭으로 되어 있습니다.

상단 바

탭 구성

5. 설정하기 ① 계좌 / API

설정 탭을 열면 맨 위에 계좌/API 설정이 있습니다. 여기부터 채웁니다.

1. 계좌번호 — 한국투자증권 계좌번호를 입력합니다. (예: 12345678-01)
2. 앱 키 · 시크릿 키 — KIS Developers에서 복사한 값을 붙여넣습니다.
3. 모의투자 체크박스 — 모의투자 계좌로 테스트할 때는 반드시 체크하고, 모의계좌번호와 모의용 키를 입력하세요. 실전으로 전환할 때는 체크를 해제하고 실전 정보로 바꿔 넣습니다.
4. 토큰 발급 버튼을 눌러 정상적으로 토큰이 발급되는지 확인합니다. 오류가 나면 계좌번호나 키에 오타가 없는지 확인하세요.

6. 설정하기 ② 운용 설정

7. 설정하기 ③ 집중매집 3단계

평균단가 대비 주가가 크게 떨어졌을 때, 평소보다 몇 배로 더 사서 평단가를 빠르게 낮추는 선택 기능입니다.

각 단계는 왼쪽 체크박스로 개별적으로 켜고 끌 수 있고, 하락률과 배수도 자유롭게 바꿀 수 있습니다.

각 단계는 "한 번씩만" 실행됩니다

집중매집은 하루 단위로 초기화되지 않습니다. 한 번 보유를 시작한 뒤 전량 청산될 때까지, 각 단계는 딱 한 번씩만 실행됩니다.

전량 청산이 끝나면 기록이 지워지므로, 다시 매수를 시작한 뒤에는 1단계부터 새로 적용됩니다. 이 진행 상황은 저장되기 때문에 PC를 껐다 켜도 그대로 유지됩니다.

8. 설정하기 ④ 종목 설정 (가장 중요)

실제로 어떤 종목을, 얼마씩, 몇 번에 나눠 살지 정하는 곳입니다. + 종목 추가 버튼으로 최대 10개까지 등록할 수 있습니다.

각 열의 의미

숫자는 이렇게 정하세요

즉 최대 투자금액 ÷ 분할횟수 = 1일 매수금액이 되도록 잡으면 계산이 맞아떨어집니다. 분할횟수를 늘릴수록 하루 매수금액이 작아지고, 더 오래 천천히 담게 됩니다.

설정을 모두 마쳤으면 우측 하단의 💾 저장 버튼을 꼭 눌러주세요. 저장하지 않으면 반영되지 않습니다.

9. 자동매매 시작하고 확인하기

1. 설정 탭에서 저장을 누릅니다.
2. 화면 오른쪽 위의 ▶ 시작 버튼을 누릅니다.
3. 상단 표시등이 '실행'으로 바뀌고, 예수금·총평가 금액이 채워집니다.
4. 매매현황 탭의 실행 로그에 동작 내역이 실시간으로 쌓입니다.

매매현황 탭에서 볼 수 있는 것

10. 휴대폰 푸시 알림 설정 (ntfy)

체결이나 주요 이벤트를 휴대폰으로 바로 받아볼 수 있습니다. 무료 앱 ntfy를 사용합니다.

1. 휴대폰에 ntfy 앱을 설치합니다. (Android: Google Play / iPhone: App Store)
2. 설정 탭의 푸시 알림(ntfy) 체크박스를 켭니다.
3. 랜덤 생성 버튼을 눌러 고유 토픽을 만듭니다. (예: ft-k3n8)
4. 휴대폰 ntfy 앱에서 똑같은 토픽을 구독합니다.
5. 테스트 전송 버튼을 눌러 휴대폰에 알림이 오는지 확인합니다.

11. 거래내역 조회 · 엑셀 내보내기

결과 탭에서 기간별 거래내역과 요약 통계를 확인할 수 있습니다.

12. 라이선스 등급과 운용자금 한도

라이선스는 계좌의 총 운용자금(총평가금액) 기준으로 등급이 나뉩니다.

장 마감 무렵 하루 한 번 총잔액을 확인해, 등급 한도를 넘으면 업그레이드 유예 기간(기본 3일)을 부여합니다. 유예 기간이 지나도 계속 초과 상태면 신규 매수만 제한되며, 매도와 익절은 항상 정상 작동합니다. 한도 아래로 내려오면 제한은 자동으로 풀립니다.

13. 차수별익절 (선택 기능)

기본 전략은 종목 전체가 목표 수익률에 닿으면 한 번에 전량매도합니다. 차수별익절은 여기에 얹는 선택 기능으로, 매수 회차마다 산 가격을 따로 기억해 두었다가 가장 싸게 산 회차가 설정한 %만큼 오르면 그 회차 수량만 팔아 차익을 챙깁니다. 오르내림이 반복되는 구간에서 조금씩 이익을 쌓는 방식입니다.

설정 탭의 종목 설정 표에서 종목마다 체크해서 켜고, 숫자(매도 트리거 %, 재매수 %)는 위쪽 차수별익절 설정란에서 켜진 종목 전체에 공통으로 정합니다.

동작 규칙

판 만큼 되사서 반복 (오실레이션)

매도한 수량·가격을 기억해 두었다가 그 가격 대비 −5% 내려오면 같은 수량을 되삽니다. 다시 오르면 또 팔고, 이렇게 하루에도 여러 번 매도↔재매수를 반복합니다.

회차 단가 P를 +5%에 팔고 그 매도가 대비 −5%에 되사므로, 되사는 가격은 P × 1.05 × 0.95 = 0.9975P — 원래보다 0.25% 쌉니다. 그래서 회전이 쌓일수록 평단가가 조금씩 내려갑니다.

상승이 이어지면 (계단식 매도)

매도 대상은 항상 남은 회차 중 가장 싼 것입니다. 하나 팔면 그다음 싼 회차가 대상이 되고, 그 회차의 +5%에 닿으면 또 팝니다. 즉 오를수록 싼 회차부터 차례로 정리됩니다.

과열 구간 일시중지 (선택)

설정 탭 차수별익절 줄 오른쪽의 "평단가 대비 손익률이 N% 보다 높으면 중지"를 켜면, 종목 전체 손익률이 기준을 넘는 동안 회차 매도를 멈춥니다. 크게 오르는 중에 +5%씩 잘라 팔아 상승분을 놓치는 것을 막는 장치이며, 손익률이 기준 이하로 내려오면 자동으로 재개됩니다.

N은 음수도 됩니다. 기본값 −10%는 "손익률이 −10%보다 높은 동안(= 크게 물리지 않은 평소)은 회차 매도를 하지 않고 그냥 들고 가다가, −10% 아래로 깊게 물렸을 때만 회차 매도↔재매수를 돌려 차익을 쌓는다"는 뜻입니다. 기준값과 정확히 같으면 작동합니다(−10.00%는 매도, −9.99%는 중지).

수동으로 산 종목도 적용됩니다

프로그램으로 사지 않았어도, 차수별익절을 켜면 최근 1년 실제 체결내역을 불러와 보유분을 실제 매수가 회차로 복원합니다. MTS·HTS로 담아둔 종목도 차수별익절이 바로 작동합니다.

어떤 장에 유리한가

14. 손절 재분할 (선택 기능)

최대 투자금액까지 다 채워서 더 이상 살 수 없는 상태인데 주가가 계속 내려가면, 평단가를 낮출 방법이 없어 그대로 물리게 됩니다. 손절 재분할은 이때 보유 수량의 일부를 손절해 만든 자금으로 다시 여러 번에 나눠 담아 평단가를 끌어내리는 기능입니다.

설정 탭의 종목 설정 표에서 종목마다 체크해서 켜고, 숫자는 위쪽 손절재분할 설정란에서 정합니다.

동작 조건과 규칙

실효 최대투자금액

손절한 금액만큼은 최대 투자금액 한도에서 빼줍니다. 그래야 손절로 만든 자금으로 다시 담을 수 있기 때문입니다. 상세 패널에는 이 계산이 그대로 표시됩니다.

중단되면 어떻게 되나요

누적 손실 한도나 최대 사이클에 도달하면 그 종목의 손절 재분할이 멈추고, 매매현황 표의 손절재분할 열에 중단(한도)으로 표시됩니다. 설정에서 한도를 올리면 다음 확인 주기에 다시 풀립니다. 이 상태에서도 일반 매수·매도와 차수별익절은 정상 동작합니다.

15. 상세 패널 읽는 법

매매현황 탭의 보유종목 표에서 종목을 클릭하면 아래 패널이 좌우 두 칸으로 나뉘어, 왼쪽에 차수별익절, 오른쪽에 손절 재분할 정보가 표시됩니다. 두 칸은 각자 스크롤되므로 회차가 많아도 손절 쪽을 함께 볼 수 있습니다. 보유·평단·현재가·수익률은 두 칸 위에 한 줄로 공통 표시됩니다.

차수별익절 표 — 열 읽는 법

보유 중인 매수 회차를 싼 것부터 한 줄씩 나열합니다. 팔린 회차는 목록에서 빠지고, 되산 수량은 새 회차로 다시 들어옵니다.

색으로 구분되는 것

표 아래 요약줄

16. NXT 시간외 매매 (선택 기능)

정규장(09:00~15:30) 밖에서도 사고팔 수 있게 해 주는 기능입니다. 대체거래소 넥스트레이드(NXT)를 통해 거래하며, 설정 탭의 [NXT 시간외 매매]를 체크하면 켜집니다.

시간외에 도는 것 / 돌지 않는 것

장이 끝난 뒤 오른 것을 다음 날까지 기다리지 않아도 되고, 판 것을 그날 안에 되살 수 있다는 것이 이 기능의 요점입니다. 판단 우선순위는 정규장과 똑같습니다.

알아두실 점

• 지정가만 됩니다. NXT는 시장가를 받지 않습니다. 3분마다 미체결 주문을 취소하고 그때 가격으로 다시 걸며, 5회까지 시도합니다.
• 종목마다 다릅니다. NXT에 상장되지 않은 종목은 시간외에 거래되지 않습니다. 매매현황 표의 [NXT] 열에 가능 / 불가 / 미확인 / 꺼짐으로 표시됩니다. ‘미확인’은 아직 확인하지 않았다는 뜻이지 거래가 안 된다는 뜻이 아닙니다 — 프로그램이 켜져 있고 보유 중이면 곧 채워집니다.
• 거래가 한산합니다. 주문을 걸어도 붙지 않는 일이 흔합니다. 로그에 ‘주문 접수’만 있고 ‘매도체결’이 없으면 그 경우입니다.
• 모의투자는 지원하지 않습니다. KIS 모의투자 서버가 NXT를 다루지 않습니다. 설정 탭 체크박스에도 ‘(모의투자 미지원)’이라고 적혀 있습니다.
• 현재가가 MTS와 다르게 보입니다. 시간외에는 화면에 NXT 실시간 시세를 보여 줍니다. MTS에서 KRX 시세를 보고 계시면 그쪽은 정규장 종가에 멈춰 있어 다르게 보이는 것이 정상입니다. 엔진도 화면과 같은 NXT 값으로 판단합니다.

17. 차트 보는 법

매매현황 탭 왼쪽 아래에 있습니다. 보유종목 표에서 종목을 클릭하면 차트도 따라 바뀝니다. 주기는 1분 · 일 · 주 · 월 중에서 고릅니다(증권사가 국내주식에 직접 주는 분봉이 1분봉뿐이라 5분·30분은 넣지 않았습니다).

차트에 표시되는 것

확대 · 축소와 이동

• 커서를 올리면 십자선이 따라오고, 그 봉의 날짜·요일과 시가·고가·저가·종가, 앞 봉 대비 등락률, 거래량, 이동평균값이 작은 창으로 뜹니다. 그 봉에서 사고판 것이 있으면 체결가도 함께 나옵니다.
• 마우스 휠을 굴리면 보이는 봉 개수가 25%씩 줄고 늡니다. 지금 몇 봉인지는 차트 오른쪽 위에 표시됩니다.
• 끌어서 이동 — 차트를 누른 채 좌우로 끌면 과거 구간으로 옮겨 갑니다. 오른쪽 끝이 최신 봉입니다.
• 휠로 넓힐 수 있는 한계는 설정 탭의 표시 봉 개수(20~1200, 기본 600)입니다. 더 넓게 보려면 설정값을 먼저 올리세요.

일봉 1200개는 조회를 12번 나눠 받는 양입니다. 차트가 느리다면 표시 봉 개수를 줄이세요. 처음 여는 종목은 120봉만 먼저 그린 뒤 나머지를 이어서 채우므로, 봉 수가 갑자기 늘어나는 것은 정상입니다.

18. 종목 탭 — 투자 유니버스

설정 탭의 종목 목록은 지금 돌리는 것만 담습니다. 한 번 매매하고 지운 종목, 나중에 다시 볼 종목, 조건에 걸린 후보들을 모아 두는 곳이 종목 탭입니다. 여기서 골라 설정으로 보내는 흐름입니다.

그룹으로 나눠 담기

왼쪽에서 그룹을 만들고 고릅니다. ‘네이버 검색상위’, ‘토스 거래량상위’처럼 출처별로 나눠도 되고 ‘반도체’, ‘레버리지’처럼 주제별로 나눠도 됩니다. 그룹 이름은 끌어서 순서를 바꿀 수 있고, 오른쪽 표의 종목을 왼쪽 그룹 위로 끌어다 놓으면 그 그룹으로 이동합니다(복사가 아닙니다).

붙여넣기로 한 번에 담기

[종목 추가]를 누르고 다른 사이트의 목록을 그대로 붙여넣으세요. 한 줄에 한 종목씩 인식하므로 수십 개를 한 번에 담을 수 있습니다. 종목명만 있어도 됩니다 — 순위표에는 대개 코드가 없으므로 이름으로 찾아 코드를 채웁니다. 가격·등락률·순위 같은 숫자는 알아서 걸러냅니다.

19. MTS·HTS로 직접 매매했을 때

프로그램을 켜 둔 채 휴대폰이나 HTS에서 직접 사고파셔도 됩니다. 프로그램이 알아서 반영합니다.

거래내역에 ‘수동매매’로 기록됩니다

프로그램이 켜져 있는 동안 증권사에 남은 당일 체결내역을 주기적으로 확인해, 그중 프로그램이 내지 않은 주문을 찾아 ‘수동매매’로 기록합니다. 결과 탭에서 프로그램 거래와 함께 보입니다.

직접 매도한 건은 증권사의 기간별 손익으로 실현손익까지 채웁니다(모의투자 서버는 이 조회를 지원하지 않아 0원으로 남습니다). 프로그램이 꺼져 있는 동안의 매매는 다음 실행 때 잔고를 기준으로 반영됩니다.

회차 동기화 — 원장과 잔고를 맞춥니다

차수별익절은 ‘몇 주를 얼마에 샀는가’를 회차 단위로 따로 기록해 두고 그 회차 단가를 기준으로 팝니다. 직접 매매하면 증권사 잔고와 이 기록이 어긋나므로 자동으로 맞춥니다. 로그에 [회차동기화]로 남는 줄이 그것입니다.

직접 전량 매도했을 때

잔고에서 사라지면 프로그램이 판 것과 똑같이 취급합니다. ‘청산후 재진입’이 켜져 있으면 주기매수로 다시 1회차부터 진입하고, 꺼져 있으면 그 종목은 더 사지 않습니다. 회차·손절 재분할 진행 상태도 함께 정리됩니다.

20. 프로그램이 알아서 하는 것들

자동 업데이트

프로그램을 켤 때마다 새 버전이 있는지 확인하고, 있으면 받아서 스스로 갈아끼운 뒤 다시 시작합니다. 홈페이지에서 따로 받아 덮어쓰실 필요가 없습니다.

• 확인은 켤 때 한 번뿐입니다. 켜 두고 매매하는 동안에는 바뀌지 않으므로 갑자기 재시작되는 일은 없습니다.
• 받은 파일이 서버에 등록된 것과 정확히 같은지 확인한 뒤에만 교체합니다. 다르면 하던 버전으로 그냥 켭니다.
• 인터넷이 느리거나 서버에 문제가 있어도 하던 버전으로 정상 실행됩니다. 새 버전이 문제를 일으키면 자동으로 이전 버전을 되돌려 실행합니다.
• 설정·라이선스·보유 상태 파일은 그대로 유지됩니다.

휴장일 자동 판단

거래소 달력을 하루 한 번 받아 앞으로 60일치 개장일을 확인해 둡니다. 주말·법정공휴일은 물론 대체공휴일·임시공휴일까지 거래소 확정본이라, 공휴일에도 프로그램을 그냥 켜 두시면 됩니다. 휴장일에는 조회도 주문도 하지 않고 로그에 하루 한 줄만 남습니다(푸시는 가지 않습니다).

달력을 받지 못하는 경우(모의투자 서버 등)에는 09:15 이후 ‘오늘 시세가 있는가’로 잠정 판단하고 30분 뒤 다시 확인합니다 — 개장이 늦어진 날에 하루를 통째로 놓치지 않기 위함입니다. 인터넷이 끊겨 조회에 실패한 것은 휴장의 근거로 삼지 않습니다.

주문가능금액과 축소 매수

매수 직전에 화면 상단의 주문가능 금액을 확인해, 넘칠 것 같으면 살 수 있는 수량으로 줄이거나 보류합니다. 그냥 주문을 내면 증권사가 주문가능금액 초과로 거부하고 그 실패가 30초마다 반복되기 때문입니다.

• 주기매수 · 집중매집 · 종가매매 → 살 수 있는 수량만큼 줄여서 매수합니다.
• 차수별익절 되사기 → 판 수량을 그대로 되사야 하므로 줄이지 않고 여력이 생길 때까지 보류합니다.

축소 매수가 잦다면 주문가능금액이 부족한 것입니다. 입금하시거나, 종목 수를 줄이거나, 1회 매수금액을 낮추세요.

매수를 건너뛰면 로그에 사유가 남습니다

‘왜 안 사지?’를 화면만 보고 알 수 있도록, 주기매수를 막는 관문마다 한 줄씩 남깁니다. 같은 줄이 30초마다 반복되지 않고 상황이 바뀔 때만 찍힙니다.

• 오늘 주기매수는 이미 마쳤습니다 — 다음 거래일에 재개합니다
• 최대 투자금액 도달 — 남은 여력 N원 < 현재가 N원
• 1회 매수금액 N원 < 현재가 N원 → 1주도 매수 불가, 건너뜀
• 종가매매 — 현재가가 평단 이상이라 장중 매수는 건너뜁니다
• 차수익절 매도가 대비 -N% 대기 중 — N원 이하에서 신규매수 재개
• 주문가능금액 부족 → N주 대신 N주로 축소 매수

21. 자주 묻는 질문

22. 꼭 알아두실 점

• FreeTrader는 정보 제공 및 투자 보조 도구이며, 특정 종목의 매수·매도를 권유하지 않습니다.
• 모든 매매는 본인 계좌·자금으로 이루어지며, 손익의 책임은 전적으로 사용자 본인에게 있습니다.
• 통신 장애, API 서버 문제 등으로 인한 미체결·오주문 가능성이 있으니 체결 내역을 수시로 확인하세요.
• 실전 투입 전 모의투자 테스트를 충분히 진행하시기 바랍니다.
• 손절 재분할은 손실을 확정시키는 기능입니다. 평단가를 낮추는 대신 그만큼 실현손실이 발생하며, 반등이 오지 않으면 손실만 쌓일 수 있습니다. 최대 사이클과 누적 손실 한도를 감당 가능한 수준으로 잡으세요.
• 차수별익절은 사고팔 때마다 거래세(0.18%)와 수수료가 발생합니다. 목표폭을 너무 낮추면 비용에 먹혀 손해날 수 있습니다.
• 프로그램이 켜져 있는 동안에만 매매합니다. PC를 끄거나 절전 상태로 두면 그동안은 아무 주문도 나가지 않습니다.
• 라이선스 키의 무단 복제·배포·공유는 엄격히 금지됩니다.
• 사용자는 자본시장법 등 관련 법령을 준수하여 프로그램을 사용해야 합니다.