get_order_history

KISSimpleOverseasStock.get_order_history(from_date: date, to_date: date, to_frame: bool = False) → List[OverseasStockOrder] | DataFrame

주문 내역을 조회하여 리스트 또는 데이터프레임 형식으로 반환합니다.

Parameters:

• from_date (dtm.date) – 조회를 시작할 날짜. (현지 기준)

• to_date (dtm.date) – 조회를 마칠 날짜. (현지 기준)

• to_frame (bool, optional) – True일 경우 Pandas DataFrame으로 반환, False일 경우 리스트 형식의 OverseasStockOrder 객체들로 반환. 기본값은 False.

Returns:

오늘의 주문 내역 리스트 또는 DataFrame.

• 리스트 형식 (OverseasStockOrder 객체들):

  • order_no (str): 주문 번호.

  • asset_code (str): 자산 코드 (티커).

  • side (OrderSide): 매수(BUY) 또는 매도(SELL).

  • price (Decimal): 주문 가격.

  • quantity (int): 주문 수량.

  • filled_quantity (int): 체결된 수량.

  • pending_quantity (int): 대기 중인 수량.

  • order_time (datetime): 주문 시간 (현지 기준).

  • order_kr_time (datetime): 주문 시간 (한국 기준).

  • filled_price (Decimal): 체결 가격.

  • current_price (Decimal): 현재 가격.

  • is_pending (bool): 주문 대기 여부.

  • org_order_no (str): 원래 주문 번호 (수정/취소 주문의 경우).

  • order_type (str): 주문 유형 (초기값 None).

  • req_type (str): 주문 요청 유형 (정정/취소 등).

  • exchange (str): 거래소 코드.

  • currency (str): 거래 통화 코드.

• 데이터프레임 형식 (to_frame=True):

  • 주문 번호(order_no)를 인덱스로 한 Pandas DataFrame.

  • 나머지 필드는 위와 동일하며, 가격과 수량은 숫자 형식으로 변환됨.

Return type:

List[OverseasStockOrder] | pd.DataFrame

Raises:

ValueError – API 호출 중 문제가 발생할 경우 발생.