선물 월물 교체, 만기 다음 날 봇이 조용히 멈추는 이유

2026-11-13 알고랩

코스피200 선물이나 미니 선물 봇이 만기 다음 날 아침부터 주문을 한 건도 안 낸다면 종목코드를 어디에 적어 뒀는지부터 보세요. 선물은 만기가 지나면 그 종목이 없어집니다. 어제까지 쓰던 코드는 오늘 종목 목록에 없고, 봇은 없는 종목의 시세를 기다리며 하루를 보냅니다. 오류도 안 뜹니다. 매일 장이 열리기 전에 증권사 종목 마스터에서 그날의 최근월물 코드를 받아 쓰게 하면 풀립니다.

이 글을 쓰는 2026년 11월 13일이 마침 미니코스피200 선물 11월물의 만기 다음 날입니다. 오늘 아침에 한국투자증권(KIS) 종목 마스터를 받아 봤고, 본 그대로 옮깁니다.

오늘 아침 마스터에는 11월물이 없습니다

KIS는 지수선물과 옵션의 종목 목록을 fo_idx_code_mts.mst라는 파일로 줍니다. 로그인 없이 받는 파일이고, 공식 저장소 open-trading-api의 stocks_info/domestic_index_future_code.py가 이 파일을 내려받아 엑셀로 바꿔 줍니다. 오늘 받은 파일은 만들어진 시각이 06시 55분이었고 7,821줄이었습니다. 그중 코스피200 선물과 미니 선물만 추리면 이렇습니다.

fo_idx_code_mts.mst, 2026-11-13 06:55 생성분

1|A01612|KR4A016C0004|F 202612| |00000.00|1|2001|KOSPI200
1|A01703|KR4A01730006|F 202703| |00000.00|2|2001|KOSPI200
1|A01706|KR4A01760003|F 202706| |00000.00|3|2001|KOSPI200
1|A01709|KR4A01790000|F 202709| |00000.00|4|2001|KOSPI200
1|A01712|KR4A017C0003|F 202712| |00000.00|5|2001|KOSPI200
1|A01806|KR4A01860001|F 202806| |00000.00|6|2001|KOSPI200
1|A01812|KR4A018C0002|F 202812| |00000.00|7|2001|KOSPI200
B|A05612|KR4A056C0005|미니F 202612| |00000.00|1|2001|KOSPI200
B|A05701|KR4A05710004|미니F 202701| |00000.00|2|2001|KOSPI200
B|A05702|KR4A05720003|미니F 202702| |00000.00|3|2001|KOSPI200
B|A05703|KR4A05730002|미니F 202703| |00000.00|4|2001|KOSPI200
B|A05704|KR4A05740001|미니F 202704| |00000.00|5|2001|KOSPI200
B|A05705|KR4A05750000|미니F 202705| |00000.00|6|2001|KOSPI200

칸 이름은 공식 스크립트에 적힌 대로 상품종류, 단축코드, 표준코드, 한글종목명, ATM구분, 행사가, 월물구분코드, 기초자산 단축코드, 기초자산 명입니다. 첫 칸이 1이면 코스피200 선물, B면 미니코스피200 선물입니다. 일곱째 칸 월물구분코드가 1인 줄이 최근월물입니다.

미니 쪽에 202611이 없습니다. 11월물은 어제(11월 12일 목요일)가 마지막 거래일이었고 오늘 파일에서는 줄째로 빠졌습니다. 최근월물 자리에는 12월물 A05612가 올라와 있습니다. 어제까지 11월물 코드로 돌던 미니 봇이 있다면 오늘은 이 목록에 없는 종목을 조회하고 있을 겁니다. 코스피200 선물은 분기월에만 만기가 있어서 12월물 A01612가 그대로 최근월물입니다.

만기일은 두 번째 목요일입니다

두 상품의 최종거래일 규칙은 같고 결제월만 다릅니다. 증권사 상품안내에 올라온 명세를 확인해서 적었습니다.

항목코스피200 선물미니코스피200 선물
결제월3, 6, 9, 12월매월
상장 종목 수3년 이내 7개연속 6개월
최종거래일결제월의 두 번째 목요일. 휴장일이면 앞으로 당김
최종거래일 거래 시간08:45부터 15:20까지 (평소는 15:45까지)
결제현금결제, 최종결제일은 다음 거래일

위 마스터의 줄 수가 이 표와 맞습니다. 코스피200 선물 7줄, 미니 6줄입니다. 미니는 매달 만기가 오니 월물 교체도 1년에 12번입니다. 코스피200 선물용으로 만든 코드를 미니에 그대로 쓰면 석 달에 한 번 하던 일이 매달 돌아옵니다.

만기일은 달력으로 계산할 수 있습니다.

from datetime import date, timedelta

def last_trading_day(year, month, holidays=()):
    d = date(year, month, 1)
    d += timedelta(days=(3 - d.weekday()) % 7)   # 첫 번째 목요일
    d += timedelta(days=7)                        # 두 번째 목요일
    while d in holidays or d.weekday() >= 5:      # 휴장일이면 앞으로 당긴다
        d -= timedelta(days=1)
    return d

for y, m in [(2026, 11), (2026, 12), (2027, 1), (2027, 2), (2027, 3)]:
    print(y, m, last_trading_day(y, m))
2026 11 2026-11-12
2026 12 2026-12-10
2027 1 2027-01-14
2027 2 2027-02-11
2027 3 2027-03-11

12월 10일은 코스피200 선물과 미니 선물의 만기가 겹치는 날입니다. holidays에는 KRX 휴장일을 넣어야 하는데, 위 출력은 비워 두고 돌린 값이라 그 주에 임시 휴장이 생기면 달라집니다. 휴장일을 어디서 받는지는 KRX 휴장일을 봇이 확인하는 방법에 적어 뒀습니다.

만기일에는 마감 시각도 다릅니다. 만기 종목은 15시 20분에 거래가 끝납니다. "장 마감 5분 전에 전부 청산"을 15시 45분 기준으로 만든 봇은 만기일에 청산 주문을 내 보지도 못합니다. 남은 계약은 현금결제로 정리되니 큰 사고는 아니어도, 내가 정한 가격에 나오지 못한 겁니다. 저희가 만든 한투 미니코스피200 선물 봇은 만기일에 프로그램을 켜면 경고부터 띄웁니다.

코드 앞자리가 1에서 A로 바뀌었습니다

위 목록을 보고 이상하다고 느끼셨다면 예전 코드를 아시는 분입니다. 코스피200 선물 코드는 오랫동안 101로 시작했습니다. KIS 공식 예제에도 101W09가 적혀 있었고, 저희가 전에 쓴 KIS 국내 선물옵션 주문 글도 그 예시를 그대로 옮겼습니다. 지금 마스터에는 A01612입니다.

한국거래소가 파생상품 코드 체계를 바꾼 결과입니다. 2023년 1월 대신증권의 제도개편 안내에 이유가 나옵니다. 선물 코드는 종류, 거래대상, 만기 연도, 만기 월 순서로 만드는데 연도 글자가 30년마다 되돌아옵니다. 1996년 12월물과 2026년 12월물이 둘 다 1016C가 됩니다. 그래서 종류 자리에 영문을 쓰기로 했고, 선물은 A, 콜옵션은 B, 풋옵션은 C, 선물 스프레드는 D입니다. 같은 안내문의 예시에서 2026년 12월물은 A016C입니다. 오늘 마스터의 표준코드 KR4A016C0004에 그 다섯 글자가 들어 있습니다.

단축코드는 A01(코스피200 선물)이나 A05(미니) 뒤에 연도 한 글자와 월 두 자리를 붙인 꼴입니다. 2026년이 6, 2027년이 7입니다. 예전 예제의 101W09는 같은 식으로 읽으면 W년 9월물입니다.

이 변경은 만기가 2026년인 종목부터 보입니다. 규칙대로라면 2025년 12월물이 만기된 다음 날, 최근월물이 2026년 3월물로 넘어가면서 봇이 쓰는 코드의 첫 글자가 처음 A가 됐을 겁니다. 그날 직접 본 것은 아니어서 추정으로 적습니다. 코드에 이런 줄이 있으면 고쳐야 합니다.

if not code.startswith("101"):      # 2026년 만기 종목부터 통과하지 못한다
    raise ValueError("코스피200 선물 코드가 아님")

코드 모양으로 상품을 가리지 말고 마스터의 첫 칸(상품종류)으로 가리면 됩니다. 저희는 백테스트 데이터를 월물별로 저장할 때도 코드 형식에 기대지 않게 만들었습니다. 날짜마다 봉이 가장 많은 월물을 골라 이어 붙이는 방식이라 코드 꼴이 또 바뀌어도 손댈 곳이 없습니다.

아침마다 코드를 받아 옵니다

파이썬 표준 라이브러리만으로 됩니다. 파일로 저장하지 않고 메모리에서 풀어 읽습니다.

front_month.py

import io
import zipfile
import urllib.request

MASTER_URL = "https://new.real.download.dws.co.kr/common/master/fo_idx_code_mts.mst.zip"

def load_master():
    raw = urllib.request.urlopen(MASTER_URL, timeout=30).read()
    with zipfile.ZipFile(io.BytesIO(raw)) as z:
        text = z.read("fo_idx_code_mts.mst").decode("cp949")
    return [line.split("|") for line in text.splitlines()]

def front_month(rows, kind):
    # kind: "1" 코스피200 선물, "B" 미니코스피200 선물
    for r in rows:
        if r[0] == kind and r[6] == "1":
            return r[1], r[3].strip()
    raise RuntimeError(f"최근월물을 찾지 못함: kind={kind}")

rows = load_master()
print(front_month(rows, "1"))
print(front_month(rows, "B"))

오늘 돌린 결과입니다.

('A01612', 'F 202612')
('A05612', '미니F 202612')

이 값을 주문 본문의 SHTN_PDNO에 넣습니다. 인코딩은 cp949입니다. utf-8로 읽으면 한글종목명에서 오류가 납니다.

못 찾으면 RuntimeError로 멈추게 한 데는 이유가 있습니다. 파일을 못 받았다고 어제 코드로 계속 가면 처음의 그 조용한 실패로 돌아갑니다. 코드를 못 받은 날은 매매를 시작하지 않고 텔레그램으로 알리는 쪽이 낫습니다. 받은 코드가 어제와 다르면 그것도 한 줄 알리게 해 두면, 월물이 바뀐 날 아침에 사람이 한 번은 들여다보게 됩니다.

모르는 것도 있습니다. 만기일 당일 아침 파일에서 월물구분코드 1이 그날 만기되는 종목에 붙어 있는지는 아직 직접 보지 못했습니다. 그래서 파일만 믿지 않고 위의 날짜 계산을 같이 둡니다. 오늘이 최종거래일이면 신규 진입을 막거나, 처음부터 다음 월물(월물구분코드 2)로 들어가게 합니다.

NH투자증권은 종목 목록을 주는 API가 없고 정적 마스터 파일을 받아 쓰는 구조입니다. 증권사별로 선물 종목 목록이 어디 있는지는 미니코스피200 선물 API 비교 글에 모아 뒀습니다.

들고 있던 계약은 따로 챙겨야 합니다

코드를 새로 받는 것으로 풀리는 건 신규 주문뿐입니다. 만기 전날 들어간 계약은 옛 월물에 그대로 있습니다. 봇이 새 코드로만 잔고를 조회하면 보유가 0으로 보이고, 그 상태에서 새 월물에 또 진입합니다. 잔고는 종목을 지정하지 말고 계좌 전체로 조회해서, 지금 쓰는 코드와 다른 선물 계약이 남아 있으면 알리게 합니다.

며칠씩 들고 가는 전략이면 옛 월물을 청산하고 새 월물에 같은 방향으로 다시 들어가는 주문 두 개가 필요합니다. 두 월물은 가격이 서로 달라서 진입가와 손절가도 새 월물 기준으로 다시 잡아야 합니다. 스프레드 종목으로 한 번에 넘기는 방법도 있는데, API로 주문해 본 적이 없어서 여기에는 적지 않습니다.

지표도 같은 문제를 겪습니다. 이동평균을 11월물 봉으로 계산하다가 12월물로 넘어가면 두 월물의 가격 차이만큼 값이 튑니다. 새 월물도 여러 달 전에 상장된 종목이라 과거 봉이 있으니, 코드가 바뀐 날에는 새 코드로 봉을 다시 받아 처음부터 계산하는 편이 안전합니다. 당일에 끝나는 전략은 이 걱정이 없습니다. 앞에 적은 미니 선물 봇이 당일 청산이라 월물 사이 가격 차이를 보정하지 않았습니다.

야간장을 돌리면

KRX 야간 거래 데이터의 날짜는 체결된 날이 아니고 그 거래가 속한 거래일입니다. 미니 선물 봇의 백테스트 데이터를 넣을 때 이 날짜를 맞춰야 했습니다. 같은 식이면 만기일 저녁에 열리는 야간장은 이미 다음 거래일의 장이고 만기 종목은 거기에 없을 겁니다. 다만 만기일 저녁 야간장에서 직접 확인하지는 못했습니다. 마스터 파일이 저녁에 한 번 더 갱신되는지도 모릅니다. 오늘 본 건 06시 55분 생성분 하나입니다.

그래서 야간까지 도는 봇은 저녁 장이 열리기 전에 코드를 다시 받고, 날짜 계산으로 한 번 더 걸러 두기를 권합니다. 야간 시세와 주문에 쓰는 TR은 KIS 야간 선물옵션 글에 있습니다.

해외선물은 사정이 다릅니다

여기까지는 코스피200 계열 얘기입니다. CME 선물은 종목마다 만기 규칙이 다르고, 원유처럼 실물 인수도가 있는 상품은 만기까지 들고 가는 것 자체를 피해야 합니다. 거래량이 만기 전에 다음 월물로 먼저 옮겨 가서 넘기는 날을 달력만 보고 정하기도 어렵습니다. KIS 해외선물 자동매매 글에 따로 썼고, 저희가 만든 것 중에는 NH선물 WTI 자동매매 사례가 있습니다.

제작을 맡기실 때 정해 오시면 좋은 것

선물 봇은 월물을 어떻게 다룰지도 사양에 들어갑니다. 미리 생각해 오시면 견적이 빨리 나옵니다. 만기일에도 매매할지, 포지션을 며칠씩 들고 가는지, 들고 간다면 만기 며칠 전에 다음 월물로 넘길지입니다. 당일 청산 전략이면 만기일에 쉬거나 청산 시각만 당기면 되고 일이 적습니다. 며칠 들고 가는 전략은 넘기는 주문과 지표 재계산이 들어가서 범위가 늘어납니다. 비용은 비용 안내에서 보실 수 있습니다.

자주 받는 질문

코스피200 선물 만기일 당일에도 자동매매 주문을 낼 수 있나요?

낼 수 있지만 만기 종목은 최종거래일에 15시 20분까지만 거래됩니다. 평소 마감인 15시 45분에 맞춰 청산하도록 만든 봇은 만기일에 청산 주문을 내지 못하고, 남은 계약은 현금결제로 정리됩니다. 만기일에는 청산 시각을 당기거나 신규 진입을 막아 두세요.

미니코스피200 선물과 코스피200 선물은 만기일이 같은가요?

3월, 6월, 9월, 12월에는 같은 날입니다. 둘 다 결제월의 두 번째 목요일이 최종거래일입니다. 다만 코스피200 선물은 분기월에만 만기가 있고 미니는 매달 있어서, 미니 봇은 월물 교체가 1년에 12번 옵니다.

코스피200 선물 종목코드가 101로 시작하지 않는데 맞는 코드인가요?

맞습니다. 2026년에 만기가 오는 종목부터 코드 첫 글자가 숫자 1에서 영문 A로 바뀌었습니다. 2026년 11월 13일 한국투자증권 종목 마스터에는 코스피200 선물 12월물이 A01612, 미니 12월물이 A05612로 적혀 있습니다. 코드가 101로 시작하는지 검사하는 봇은 고쳐야 합니다.

만기 다음 날 멈춘 봇이 있으면

쓰시는 증권사와 상품, 로그에 마지막으로 찍힌 줄을 채팅으로 보내 주세요. 직접 만들던 코드도 받습니다.

채팅으로 문의하기

2026년 11월 13일에 한국투자증권 공식 저장소와 종목 마스터 파일, 증권사 상품안내와 제도개편 안내를 보고 썼습니다. 종목코드와 거래 시간, 만기 규정은 바뀔 수 있으니 주문 전에 한국거래소와 이용하시는 증권사의 공지를 확인하세요. 선물은 레버리지 상품이라 원금을 넘는 손실이 날 수 있습니다. 알고랩은 프로그램 제작 도구를 제공하며 투자자문업과 투자일임업을 영위하지 않습니다.