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 호출 중 문제가 발생한 경우.