get_scheduled_orders#
- KISSimpleOverseasStock.get_scheduled_orders(start_date: date | None = None, end_date: date | None = None, include_cancelled: bool = False, to_frame: bool = False) List[dict] | DataFrame [source]#
지정된 기간 동안의 예약 주문 목록을 조회합니다.
- Parameters:
start_date (datetime.date, optional) – 현지 기준 조회할 시작 일자. 기본값은 당일.
end_date (datetime.date, optional) – 현지 기준 조회할 종료 일자. 기본값은 당일.
include_cancelled (bool, optional) – 취소된 예약 주문을 포함할지 여부. 기본값은 False.
to_frame (bool, optional) – True일 경우 Pandas DataFrame으로 반환, False일 경우 리스트 형식의 dict 객체들로 반환. 기본값은 False.
- Returns:
- 예약 주문 목록.
각 사전에는 다음과 같은 정보가 포함됩니다:
is_cancelled (str): 주문 취소 여부.
reservation_date (str): 현지 기준 예약 주문 접수 일자 (YYYYMMDD).
order_no (str): 해외 예약 주문 번호.
asset_code (str): 자산 코드 (티커).
order_date (str): 주문 일자 (YYYYMMDD).
side (str): 매수/매도 구분 코드.
side_name (str): 매수/매도 구분 명칭.
ticker (str): 상품 번호 (티커).
name (str): 상품명.
quantity (str): 주문 수량.
price (str): 주문 단가.
filled_quantity (str): 체결 수량.
filled_price (str): 체결 단가.
fail_reason (str): 주문 미체결 사유 (존재할 경우).
- Return type:
List[dict]
- Raises:
ValueError – API 호출 중 문제가 발생한 경우.