AI 주식 매매 프로그램 4편|모의주문과 체결 확인

접수·부분 체결·응답 지연을 모의 환경에서 검증

기술2026.11.18·11분 읽기

AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

모의 주문 접수와 체결 상태를 확인하는 화면을 그린 삽화
모의 주문을 내고 체결을 확인하는 과정

백테스트에서는 주문 신호와 가상의 체결 가격을 한 번에 계산한다. 증권사 모의투자에서는 요청이 받아들여졌는지, 일부만 체결됐는지, 주문이 취소됐는지를 나중에 조회해야 한다. 이 글에서는 가짜 응답으로 중복 방지를 먼저 점검하고, 한국투자증권의 모의투자 안내를 따라 주문 한 건을 조회하는 순서를 살펴본다. 완료 기준은 수익률이 아니라 우리 기록과 증권사 모의 체결 기록을 주문번호로 맞춰 볼 수 있는 상태다.

1. 네트워크 없이 주문 상태부터 연습한다

후보표에서 기업을 골랐으면 바로 주문을 보내기 전에 종목코드, 방향, 수량, 지정가, 판단 시각, 근거 접수번호가 적힌 주문 요청서를 만든다. AI가 하는 일은 공시와 후보 선정의 이유를 설명하는 것이다. 수량·가격·환경 점검은 프로그램의 규칙으로 하고, 실습에서는 사람이 한 건씩 확인한다. 후보표를 다시 계산했을 때 같은 주문 요청은 같은 내부 번호를 갖도록 한다. 화면 새로고침이나 버튼 두 번 클릭 때문에 새 번호가 만들어지면 중복 검사에서 걸러지지 않는다.

색이 채워진 칸과 빈 칸을 나눠 부분 체결을 나타낸 삽화주문 접수와 부분 체결 구분

화면 상태 저장할 값 다음 행동
전송 전 내부 요청 번호, 종목코드, 방향, 수량·지정가 모의 환경 표시와 주문 내용 확인
접수 내부 요청 번호, 증권사 주문번호, 후보표 기준 시각 체결내역 조회
부분 체결 누적 체결 수량, 미체결 수량, 체결 금액 남은 주문을 추적
전량 체결 누적 수량, 평균 체결가, 최종 체결 시각 잔고와 비교
접수 여부 미확인 마지막 시도 시각, 오류 종류, 내부 요청 번호 재전송 없이 증권사 기록 확인
취소 이미 체결된 수량, 취소된 잔량 잔고에는 이미 체결된 수량이 남는지 확인

상태표의 ‘접수’는 주문이 생성됐다는 뜻이다. 가령 10주를 지정가 1만원으로 요청한 뒤 4주가 9,950원에, 3주가 9,980원에 체결됐다고 하자. 누적 체결 수량은 7주, 미체결은 3주다. 체결 금액은 6만9,740원이고 7주로 나눈 평균 체결가는 약 9,962.86원이다. 3주를 취소했다면 상태표에 ‘7주 체결, 3주 취소’가 남는다. 이 수량과 가격은 가상 예시다. 모의 환경에서 부분 체결을 유도하기 어렵다면 가짜 체결 응답으로 이 경우를 시험한다.

2. 한국투자증권 모의투자 환경에서 조회부터 시작한다

한국투자증권 KIS Developers에서 서비스 이용안내와 API 문서를 읽고 모의투자 계좌에 해당하는 인증 정보를 준비한다. 공식 샘플은 실전과 모의의 앱키·앱시크릿·계좌 설정을 구분한다. 모의 실습 파일에는 모의 설정만 넣고 공유 저장소나 채팅에 키를 남기지 않는다. 샘플 저장소에는 여러 함수가 들어 있으므로, 처음에는 조회 예제만 골라 쓴다. 실행 전 콘솔에 ‘모의’라는 환경 값과 가린 계좌 식별자만 표시하고, 이 값이 예상과 다르면 요청 전에 멈춘다. 공식 샘플 설정 안내

순서 샘플에서 확인할 것 화면에서 볼 결과
1. 모의 인증 공식 샘플의 인증 설정에서 svr="vps"를 사용 모의용 설정을 읽고 키 값은 표시하지 않음
2. 계좌 조회 모의 인증으로 잔고 또는 일별주문체결을 조회 기존 보유나 요청 내역을 확인
3. 주문 예제 국내주식 현금주문의 env_dv="demo"와 계좌를 확인하고 실습용 지정가·수량을 직접 점검 정상 접수 시 주문번호를 기록
4. 체결 조회 주식일별주문체결조회에서 주문일·주문번호를 대조 체결 수량과 남은 수량을 구분
5. 잔고 대조 체결 기록과 계좌 보유 수량의 변화를 비교 주문이 접수만 됐는지 실제로 몇 주가 체결됐는지 확인

현금주문 샘플에서 종목코드, 수량, 주문단가, 주문 구분의 입력값을 살펴본다. 계좌·환경과 상품의 지원 여부는 실행하는 시점의 공식 문서에서 확인한다. svr="vps"는 인증 환경이고 env_dv="demo"는 주문 샘플에서 모의를 고르는 값이다. 둘 다 일치해야 한다. 주문번호와 체결 수량을 같은 값처럼 처리하지 말고, 체결 조회에 여러 페이지가 있으면 필요한 범위를 끝까지 조회한다. 국내주식 현금주문 샘플 · 일별주문체결조회 샘플

3. 응답이 끊기면 재전송보다 조회가 먼저다

주문 요청을 보내고 시간 초과가 났다고 하자. 서버가 요청을 받지 못했을 수도 있고, 이미 받았지만 응답이 돌아오지 않았을 수도 있다. ‘실패 확정’으로 바꾸고 같은 주문을 다시 보내면 두 건이 접수될 수 있다. 내부 기록에 ‘접수 여부 미확인’을 남기고 조회부터 한다. 주문번호를 이미 받았다면 그 번호를 기준으로 확인한다. 번호가 없다면 주문일·시간대·종목·방향·수량·가격으로 후보 기록을 좁힌다. 조회 한 번에 결과가 없거나 일치하는 후보가 여럿이라면 담당자가 확인할 때까지 보류한다.

한 번 전송한 뒤 응답 지연을 표시하고 기존 주문 기록을 확인하는 삽화응답이 멈춰도 주문은 한 번만 전송

다음 실습 코드는 모의 계좌나 인터넷 연결 없이 실행된다. 요청 번호를 SQLite에 먼저 기록하고 가짜 전송 함수에 시간 초과를 일으킨다. 동일한 요청 번호를 다시 넣으면 전송 횟수가 증가하지 않는다. :memory:는 실습을 끝내면 사라지는 저장소다. 재시작을 포함해 시험하려면 파일에 저장하고 ‘전송 중’이나 ‘접수 여부 미확인’ 상태도 시작할 때 조회 대기 목록에 올린다.

import sqlite3

def submit_once(db, intent_id, send_demo):
    with db:
        inserted = db.execute(
            "INSERT OR IGNORE INTO demo_intents VALUES (?, 'sending', NULL)",
            (intent_id,),
        ).rowcount
    if inserted == 0:
        return "기존 기록 조회"

    try:
        order_id = send_demo()
    except TimeoutError:
        state, order_id = "unknown", None
    else:
        state = "accepted" if order_id else "unknown"

    with db:
        db.execute("UPDATE demo_intents SET state=?, order_id=? WHERE id=?",
                   (state, order_id, intent_id))
    return state

def demo_timeout():
    calls.append("한 번 전송")
    raise TimeoutError

calls = []
with sqlite3.connect(":memory:") as db:
    db.execute("CREATE TABLE demo_intents "
               "(id TEXT PRIMARY KEY, state TEXT, order_id TEXT)")
    assert submit_once(db, "demo-001", demo_timeout) == "unknown"
    assert submit_once(db, "demo-001", demo_timeout) == "기존 기록 조회"
    assert len(calls) == 1
    state = db.execute("SELECT state FROM demo_intents").fetchone()[0]
    print("전송 횟수:", len(calls), "/ 기록 상태:", state)

기대 출력은 ‘전송 횟수 1 / 상태 unknown’이다. 증권사가 제공하는 중복 방지 기능으로 간주할 수는 없고, 우리 프로그램이 같은 요청을 다시 보내는 상황을 막는 예제다. 서버에서 성공했는데 저장 직전에 프로그램이 꺼지면 기록은 ‘전송 중’에 머물 수 있다. 이 경우에도 먼저 대사한다. 기록을 확정하려면 증권사에서 조회한 주문번호와 체결 정보를 보관하고, 조회 결과를 갱신할 때 같은 체결을 두 번 더하지 않도록 한다. 누적 수량이 내려가거나 주문수량보다 커지는 등 예상과 다르면 즉시 표시해 원본 응답을 확인한다.

4. 네 가지 상황을 통과하면 한 건씩 실습한다

  1. 정상 응답 — 주문번호를 받은 뒤 체결조회와 잔고를 각각 열어 수량을 맞춰 본다. 지정가가 체결되지 않았다면 ‘접수 · 미체결’로 끝낼 수 있다.
  2. 부분 체결 후 취소 — 가짜 응답 4주, 3주를 합쳐 7주를 계산한다. 잔량 3주 취소 후에도 체결 수량이 유지되는지 본다.
  3. 응답 시간 초과 및 재시작 — 같은 요청이 두 번 나가지 않고 저장된 미확인 건이 재시작 후 다시 조회 목록에 나타나는지 확인한다.
  4. 운영 환경값 불일치 — 모의 환경용 설정이 하나라도 어긋나거나 계좌가 비어 있으면 주문 호출 전에 멈추는지 확인한다.

모의 결과와 백테스트를 비교할 때는 주가 방향보다 체결 가정이 얼마나 달랐는지부터 본다. 백테스트가 시가로 전량 체결을 가정하고 모의 실습이 지정가로 일부 체결됐다면, 같은 신호에서도 보유 수량과 비용이 달라진다. 실습 기록에는 후보 선정 근거, 주문 상태 변화, 실제로 확인된 모의 체결값을 함께 남긴다. 이 기록을 다음에 읽어도 어떤 숫자가 공시에서 왔고 어떤 숫자가 주문 조회에서 왔는지 알 수 있어야 한다.

이 글은 모의투자 프로그램에 관한 일반 정보다. 투자 판단은 개인 상황에 따라 다르며 필요하면 전문가와 상담해야 한다.

AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

이미지 3장은 설명용 AI 일러스트이며 실제 촬영 사진이나 실험 기록이 아닙니다.

참고 자료

참고 자료 1개 더 보기

이 글의 이미지는 AI로 생성했습니다

AI와 함께 작성

같은 가지의 다른 글

↑ 상위 글: 기술

작성: ChatGPT (GPT-6) · 검수: ChatGPT (GPT-6) · 이미지: Cloudflare (@cf/black-forest-labs/flux-2-klein-4b)