get_front_month_futures_code¶

pyqqq.utils.futures_code.get_front_month_futures_code(product: str, date: date) → str[source]¶

지수선물 상품의 특정 일자 기준 근월물(최근월물) 단축코드를 생성합니다.

만기일(결제월 두 번째 목요일) 당일까지는 해당 월물 코드를 유지하고, 다음 날부터 다음 월물로 넘어갑니다. 코드 체계는 월물의 만기 연도로 결정됩니다. (만기 2025년 이하 = 구코드 1XY…, 2026년 이상 = 신코드 AXY…)

Parameters:

product (str) – 상품 이름. 코스피200, 미니코스피200, 코스닥150 중 하나
date (datetime.date) – 기준 일자

Returns:

근월물 단축코드 (예: “A01609”, “101W09”)

Return type:

str

Raises:

ValueError – 지원하지 않는 상품 이름인 경우

Examples

>>> get_front_month_futures_code("코스피200", datetime.date(2026, 8, 5))
'A01609'
>>> get_front_month_futures_code("미니코스피200", datetime.date(2026, 8, 5))
'A05608'
>>> get_front_month_futures_code("코스피200", datetime.date(2025, 7, 21))
'101W09'