주간 읽기 01: 자동매매를 시작하는 순서

자동매매를 처음 만들 때는 작업 폴더를 확인하고, 인증의 범위를 나누고, 과거 결과의 계산 조건을 읽는 순서로 시작해 보세요. 문제가 생겼을 때 확인할 위치와 다음에 읽을 글을 함께 정리했습니다.

2026년 10월 26일호, 첫 읽기 안내입니다. 기존 공개 글을 학습 순서에 맞춰 연결했으며, 각 구현과 예제의 확인 날짜·적용 범위는 연결된 본문에서 확인할 수 있습니다.

지금 막힌 지점에서 시작하세요

첫 단계는 실행 위치를 분명히 하는 것입니다

작업 폴더가 다르면 같은 명령도 다른 설정과 파일을 읽을 수 있습니다. 먼저 wiki 1장에서 현재 위치와 작업 범위를 확인하세요. 문서, 설정, 로그와 결과를 나누면 파일이 만들어진 위치와 오류를 찾아볼 위치도 분명해집니다.

다음은 프로젝트 전용 Python 가상환경, 그다음은 한국투자증권 Open API 조회입니다. 각 단계에서는 명령을 복사하는 데서 멈추지 말고, 실제로 사용한 경로와 확인된 결과를 한 줄씩 남겨 두세요.

이미 실행 환경을 준비했다면 책 목차에서 필요한 장을 고를 수 있습니다. 데이터 수집과 저장, CCI 계산, 과거 시뮬레이션은 앞 단계에서 확인한 입력을 다음 단계로 넘기는 흐름입니다.

실행기가 늘면 토큰의 주인과 재사용 조건을 확인하세요

토큰 공유 개발 노트는 같은 로컬 파일 시스템을 공유하는 실행기들의 인증 준비를 다룹니다. 설명된 구현은 캐시 형식, 로컬 기준 발급 날짜, 계좌 식별값, 인증 정보 식별값을 비교합니다. 파일이 있다는 사실만으로 토큰을 재사용하지 않습니다.

여러 실행기가 동시에 시작할 때는 잠금을 얻은 뒤 캐시를 다시 확인하는 순서도 살펴보세요. 기다리는 동안 다른 실행기가 준비한 값을 사용할 수 있기 때문입니다. 본문의 합성 예제에서 날짜나 인증 정보 표식을 하나 바꾸어, 어느 조건에서 재사용이 중단되는지 확인할 수 있습니다.

이 글의 적용 범위는 로컬 공유 캐시입니다. 여러 서버에 걸친 분산 잠금으로 확대해 해석하지 마세요. 읽기 요청의 인증 재시도와 주문 요청의 재시도도 별개입니다. 주문 응답이 불확실할 때는 인증 캐시만 보고 같은 주문을 다시 보내는 판단을 내려서는 안 됩니다.

백테스트는 한 건의 거래를 다시 설명할 수 있어야 합니다

백테스트 안내에서는 결과를 만든 기간과 거래 기록을 먼저 확인하세요. 저장된 과거 시뮬레이션과 현재 시세, 종목별 결과와 공개 전략 기록은 각각 계산 범위가 다를 수 있습니다.

한 건을 골라 다음 질문에 답해 보세요.

1. 어떤 기간의 데이터로, 어느 시점에 신호를 계산했나요?
2. 그 신호를 계산한 뒤 이용할 수 있는 가격으로 진입했나요?
3. 비용과 미청산 보유분은 어디까지 반영했나요?
4. 완료하지 못했거나 제외한 신호에는 설명이 남아 있나요?

계산 흐름까지 직접 확인하려면 wiki 7장의 과거 시뮬레이션으로 이어가세요. 이 장은 신호 뒤의 거래 세션, 비용을 나눈 손익, 완료·제외·미완료 기록을 함께 다룹니다. 확인 결과는 사용한 데이터와 가정의 범위 안에서 읽어야 합니다.

이번 읽기에서 작은 확인 기록을 남겨 보세요

다음 양식을 자신의 작업 메모에 복사해 사용하세요. 인증 값 대신 직접 확인한 결과만 적어 두면 됩니다.

작업 위치: [프로젝트 루트와 결과 폴더]
자료 기간: [원본 데이터와 거래 기록의 시작·끝]
비용 처리: [반영 / 미반영 / 확인 필요]
다음 문서: [읽을 글 제목과 공개 링크]
확인한 내용: [직접 대조한 한 가지]
남은 질문: [다음에 확인할 한 가지]

설명할 수 없는 항목이 남으면 그 부분을 다루는 글로 돌아가세요. 결과 숫자 하나를 더 모으는 것보다, 같은 입력과 조건으로 무엇을 확인했는지 남기는 편이 다음 문제를 좁히는 데 도움이 됩니다.

처음 시작한다면 프로젝트 폴더 확인부터 이어 읽기를 선택하세요. 이미 결과를 보고 있다면 백테스트 확인 항목부터 점검하기로 이동하면 됩니다. 다음 주간 읽기와 새 개발 노트는 MediaMaak 최신 글 RSS에서 확인할 수 있습니다.