get_today_minute_data¶

KISSimpleDomesticFutureOption.get_today_minute_data(asset_code: str, session: str | FutureOptionMarket = FutureOptionMarket.DAY, market_div_code: str | None = None) → DataFrame[source]¶

당일 1분봉 데이터 검색

Note

실전계좌에서만 사용 가능합니다.
휴장일이나 장 시작 전에는 빈 DataFrame을 반환합니다.
한 번의 API 호출에 최대 102건까지 조회되므로, 장 시작까지 역방향으로 반복 호출하여 병합합니다.
야간세션(session=”night”)은 거래일 18:00 ~ 익일 06:00이며, 진행 중이면 진행 중인 세션을, 아니면 가장 최근 야간세션을 조회합니다. 자정 이후 봉의 time은 달력 기준(거래일 익일)으로 표기됩니다.

Parameters:

asset_code (str) – 종목코드 (지수선물 6자리, 지수옵션 9자리)
session (str | FutureOptionMarket) – 조회할 세션 - day:정규(주간) night:야간. 기본값은 day. 야간세션은 지수선물/지수옵션만 지원합니다.
market_div_code (str, optional) – 시장분류코드 - F:지수선물 O:지수옵션 JF:주식선물 JO:주식옵션 CF:상품선물. 기본값은 None이며 asset_code로 추론합니다. 지수선물/지수옵션 외 상품은 명시적으로 전달해야 합니다.

Returns:

분봉 데이터 (시간의 역순). time 인덱스에 open/high/low/close(float), volume/value/cum_volume/cum_value(int) 컬럼을 가집니다.

Return type:

pd.DataFrame

Raises:

ValueError – market_div_code가 None이고 asset_code로 시장분류코드를 추론할 수 없는 경우. 지원하지 않는 session 값이 전달된 경우.