주문 수량·ETF 비용 계산 수정 및 README 문구 정리

[easygap]

리밸런싱에서 이미 계획한 매수를 빼지 않고 추가 매수량을 계산해, 40만원이 부족한 계좌에 50만원어치 주문을 만드는 경우가 있었습니다. 매매 한도를 적용한 주문을 먼저 반영하고, 목표 비중의 허용 범위에 들어오면 보충 매수를 멈추도록 고쳤습니다.

• 최소 거래금액은 정수 주 수량을 정한 뒤 실제 주문금액으로 확인합니다.
• 매도 비용, 예상 체결 가격 차이, 수수료, 남겨 둘 현금을 반영해 매수 수량을 줄입니다. 실행 직전의 잔고·위험 한도 확인은 계속 거칩니다.
• 국내 ETF로 등록한 두 종목에 ETF 호가 단위(2천원 미만 1원, 그 이상 5원)를 적용합니다. 일반 주식·비과세 목록과 구분하며, 기본 슬리피지와 거래량에 따른 비용 배수는 유지합니다.
• README의 Star 요청 문구를 삭제했습니다.

비교 결과

2020-07-08~2026-09-17, ETF 적립 설정으로 전일 종가에서 수량을 정하고 다음 날 종가에 비용을 반영했습니다. 양쪽 모두 동일한 현재 비용 계산을 사용해 주문 계획의 차이를 비교했습니다.

기본 비용 조건	수정 전	수정 후
현금·비중 한도로 보류한 가상 주문	101건	3건
가상 체결	121건	106건
연환산 수익률	13.45%	13.31%
최대 낙폭	−15.28%	−15.82%

주문 보류는 줄었지만 기본 조건의 수익률과 낙폭은 좋아지지 않았습니다. 비용 3배 조건의 수익률은 12.83%→12.92%, 낙폭은 −15.44%→−15.70%였습니다. 실제 계좌 실적이나 향후 수익을 확인한 결과가 아닙니다.

기간별 수치, 불리한 결과, 자료 날짜, 모형의 한계와 재현 명령은 docs/REBALANCE_REVIEW_20260922.md에 기록했습니다. 주문 실행부와 기존 계좌 기록에 접근하지 않고 비교했습니다.

근거

2026년 9월 22일 확인했습니다.

• 한국거래소 ETF 매매절차: ETF 호가 단위
• Vanguard, Delivering on design, 2026-08-14: 비중 조정 시 거래비용과 허용 범위를 함께 고려하는 방식
• QuantConnect 체결 모형 안내: 주문 결정 시점과 체결 가정 구분

검증

• 수정 전 오류를 재현하는 테스트 실패를 확인한 뒤 코드 수정
• 추가 매수 중복, 최소 거래금액, 매매 한도, 매수 비용·순매도 대금, ETF 호가 경계값 검증
• 비교 도구의 미래 가격 차단, 적립금 수익률 중립, 실제 계좌 접근 금지 검증
• 문서 상대 링크 23개 확인
• 관련 비용·주문 실행 테스트 136개 통과
• Windows 전체 테스트 2,083개 통과 (317.74초)
• GitHub Ubuntu 자동 검사 2,083개 통과 (136.06초): https://github.com/easygap/quant_trader/actions/runs/35700574844