추석 휴장 자동매매 봇 — 연휴 전후 체크 7가지

연휴는 봇을 가장 자주 깨뜨리는 구간입니다. 장이 열리는 날은 코드가 매일 검증되지만, 닷새 동안 아무도 안 보는 사이에 토큰이 만료되고 크론은 계속 돌고 상태 파일은 옛날 값을 들고 있습니다. 그리고 재개장 첫 9시에 그 모든 것이 한꺼번에 터집니다.

이 글은 개장일을 판정하는 방법을 비교하는 글이 아닙니다. 그건 주식 휴장일 조회 — 봇 개장일 판정 3가지 비교에 정리해 두었습니다. 여기서는 2026년 추석이라는 구체적인 닷새를 두고, 연휴 전 마지막 거래일부터 재개장 첫날까지 봇에서 실제로 확인해야 하는 일곱 군데만 봅니다.

이번 연휴, 봇의 달력은 이렇게 생겼다

사람의 달력과 봇의 달력은 다릅니다. 사람에게 연휴는 목요일부터지만, 국내 야간파생을 보는 봇에게 연휴는 수요일 저녁 6시부터입니다.

체크 ① 휴장일을 사람이 아니라 코드가 아는가

연휴 사고의 절반은 날짜를 코드에 직접 박아 둔 것에서 나옵니다. 올해는 맞지만 내년에는 틀리고, 대체공휴일이 추가로 지정되면 그날부터 틀립니다.

한국투자증권 KIS API에는 국내휴장일조회가 있습니다. GET /uapi/domestic-stock/v1/quotations/chk-holiday 이고 tr_id 는 CTCA0903R 입니다. 응답에서 봐야 할 필드는 opnd_yn(개장일 여부) 하나입니다.

# KIS 국내휴장일조회 — 응답에서 개장일만 뽑는다 (필드 구조 예시)
{
  "rt_cd": "0",
  "msg_cd": "MCA00000",
  "output": [
    {"bass_dt": "20260923", "wday_dvsn_cd": "04", "bzdy_yn": "Y", "tr_day_yn": "Y", "opnd_yn": "Y", "sttl_day_yn": "Y"},
    {"bass_dt": "20260924", "wday_dvsn_cd": "05", "bzdy_yn": "N", "tr_day_yn": "N", "opnd_yn": "N", "sttl_day_yn": "N"},
    {"bass_dt": "20260925", "wday_dvsn_cd": "06", "bzdy_yn": "N", "tr_day_yn": "N", "opnd_yn": "N", "sttl_day_yn": "N"},
    {"bass_dt": "20260928", "wday_dvsn_cd": "02", "bzdy_yn": "Y", "tr_day_yn": "Y", "opnd_yn": "Y", "sttl_day_yn": "Y"}
  ]
}

봇에 붙이는 형태는 단순합니다. 주문 루프에 들어가기 전에 게이트를 하나 두는 것입니다.

# 개장일 게이트 — 주문 로직보다 위에 둔다
import datetime, json, os

CACHE = "holiday_2026.json"   # 하루 한 번만 받아 캐시한다

def open_days() -> set:
    """KIS chk-holiday(CTCA0903R) 응답에서 opnd_yn == 'Y' 인 날짜만 모은다."""
    with open(CACHE, encoding="utf-8") as f:
        rows = json.load(f)["output"]
    return {r["bass_dt"] for r in rows if r["opnd_yn"] == "Y"}

def is_trading_day(d: datetime.date, days: set) -> bool:
    return d.strftime("%Y%m%d") in days

if __name__ == "__main__":
    days = open_days()
    today = datetime.date.today()
    if not is_trading_day(today, days):
        print(f"[skip] {today} 휴장 — 주문 루프로 내려가지 않는다")
        raise SystemExit(0)
    # ... 여기서부터 시세 조회·주문 ...

핵심은 raise SystemExit(0) 입니다. 휴장일에 오류로 죽지 말고 정상 종료해야 감시 도구가 재시작을 반복하지 않습니다. 캐시를 쓰는 이유는 호출 한도 때문입니다 — 매 루프마다 휴장일을 조회하면 정작 시세와 주문이 쓸 한도를 잡아먹습니다. pykrx 나 exchange_calendars 의 XKRX 캘린더를 쓰는 방법과의 장단 비교는 휴장일 판정 3가지 비교에 있습니다.

체크 ② 야간파생은 23일 저녁부터 없다

국내 파생을 보는 봇이라면 이번 연휴에서 가장 먼저 닫히는 문이 여기입니다. 한국거래소는 9월 23일 오후 6시부터 24일 오전 6시까지 예정돼 있던 파생상품 야간거래를 휴장한다고 공지했습니다. 대상은 코스피200·미니코스피200·코스닥150 선물과 옵션, 코스피200·코스닥150 위클리옵션, 미국달러선물, 3년·10년 국채선물 입니다.

거래소가 밝힌 사유는 장기 연휴를 사이에 두고 거래분이 오래 위험에 노출되는 것을 고려했다는 것입니다. 연휴 중 가격이 급변하면 마진콜·반대거래·유동성 부족 같은 부담이 커지기 때문입니다.

야간파생 휴장 일정은 연휴마다 거래소가 개별 공지합니다. 정규장 휴장일과 규칙이 다르므로 한국거래소 공식 공지로 매번 확인하십시오.

체크 ③ 미체결 주문은 연휴를 넘지 못한다

국내주식 일반 주문은 당일 유효가 원칙입니다. 9월 23일에 걸어 둔 지정가가 체결되지 않으면 그날 장 마감과 함께 소멸하고, 9월 28일에 저절로 되살아나지 않습니다.

여기서 깨지는 것은 증권사가 아니라 봇이 들고 있는 상태입니다. 봇의 내부 장부에 그 주문이 “미체결” 로 남아 있으면, 재개장 아침에 이미 존재하지 않는 주문번호로 정정·취소를 시도합니다.

체크 ④ 닷새를 버티는 토큰

연휴 사고 중 가장 조용하게 터지는 것이 토큰입니다. 장이 열리는 동안에는 매일 갱신되니 문제가 드러나지 않다가, 닷새 쉬고 나면 재개장 첫 호출이 인증 오류로 떨어집니다.

• 한국투자증권 KIS — access_token 유효기간과 재발급 간격 제한이 있습니다. 토큰을 파일에 캐시해 두고 만료 시각을 같이 저장해야 합니다. 자세한 것은 KIS 접근토큰 만료·재발급에 있습니다.
• 키움 REST API — 토큰 발급과 폐기가 별도 엔드포인트입니다. 연휴 중 재발급을 반복하다 이전 토큰을 정리하지 않으면 지저분해집니다. 키움 REST 토큰 만료·폐기를 참고하십시오.
• 공통 — appkey·appsecret 자체는 만료되지 않지만, 운영 서버의 시간이 틀어지면 서명·타임스탬프 검증에서 막힙니다. 연휴 전에 서버 시각 동기화를 한 번 확인하십시오.

체크 ⑤ 코인과 해외는 그대로 돈다

추석은 한국 주식시장의 휴일이지 시장 전체의 휴일이 아닙니다.

가상자산 쪽이 오히려 위험한 이유는 감시 밀도가 떨어지기 때문입니다. 평소라면 이상한 체결을 사람이 몇 시간 안에 발견하지만, 연휴에는 닷새가 지나서야 봅니다. 업비트 REST·WebSocket 로 실시간을 보는 구조라면 연결 끊김 재접속과 일일 손실 한도가 실제로 동작하는지 연휴 전에 한 번 확인하십시오.

체크 ⑥ 매도 대금은 9월 29일에 들어온다

국내주식 매도 대금은 체결일로부터 영업일 기준 이틀 뒤에 결제되는 것이 일반적입니다. 세는 단위가 달력일이 아니라 영업일이라, 연휴가 끼면 그만큼 밀립니다.

봇이 출금 가능 금액이나 D+2 예수금을 기준으로 다음 매수 수량을 계산하고 있다면, 이 구간에서 평소와 다른 값이 보입니다. 잔고 필드를 잘못 고르면 없는 돈으로 주문을 내거나, 있는 돈을 못 쓰고 그냥 쉽니다. 매수 여력 필드 선택은 KIS 매수가능조회에 정리해 두었습니다.

체크 ⑦ 재개장 첫 30분

닷새 동안 쌓인 뉴스가 9월 28일 월요일 시초가 한 점에 한꺼번에 반영됩니다. 갭이 크면 변동성완화장치(VI) 가 걸리고, VI 구간에서는 주문이 평소처럼 처리되지 않습니다.

• 시장가를 기본값으로 두지 말 것 — 갭 구간의 시장가는 의도한 가격과 크게 어긋날 수 있습니다. 주문 유형 선택은 주문 유형 — 시장가·지정가·조건부를 참고하십시오.
• VI를 장애로 오판하지 말 것 — 거부 응답을 재시도 루프에 넣으면 호출 한도만 태웁니다. VI 발동 시 봇 주문에 동작이 정리돼 있습니다.
• 첫 루프는 조회부터 — 재개장 직후 첫 동작을 주문이 아니라 잔고·미체결 조회로 두면, 상태가 어긋나 있어도 주문을 내기 전에 발견합니다.
• 지표 창이 비어 있는지 확인 — 20일 이동평균 같은 지표를 최근 N일로 계산할 때, 휴장일이 낀 구간을 달력일로 잘라 오면 데이터가 모자란 채로 신호가 나옵니다.

운영 루틴을 처음부터 잡는 단계라면 봇 첫 30일 — 온보딩과 안정화에 평소 점검 항목이 정리돼 있습니다. 증권사별 연결 구조 전반은 한국투자증권 KIS API 자동매매 허브에서 볼 수 있습니다.