order_resv#

KISOverseasStock.order_resv(cano: str, acnt_prdt_cd: str, pdno: str, ovrs_excg_cd: str, ft_ord_qty: int, ft_ord_unpr3: Decimal, sll_buy_dvsn_cd: str, rvse_cncl_dvsn_cd: str | None = None, prdt_type_cd: str | None = None, rsvn_ord_rcit_dt: str | None = None, ord_dvsn: str | None = None, ovrs_rsvn_odno: str | None = None)[source]#

해외주식 예약주문접수[v1_해외주식-002]

해외주식 예약 주문을 접수하는 함수입니다. 미국, 중국, 홍콩, 일본, 베트남 시장의 주식을 예약 매매할 수 있습니다.

미국 거래소 운영 시간 외에 예약 주문을 하거나, 기타 해외 거래소에 대해 지정가 주문을 할 수 있습니다. 미국 예약 매도 주문의 경우 MOO(장 개시 시장가) 주문도 가능합니다.

Parameters:
  • cano (str) – 종합계좌번호 (8자리).

  • acnt_prdt_cd (str) – 계좌상품코드 (2자리).

  • pdno (str) – 상품번호

  • ovrs_excg_cd (str) – 해외 거래소 코드 (예: NASD: 나스닥, NYSE: 뉴욕).

  • ft_ord_qty (str) – 주문 수량.

  • ft_ord_unpr3 (str) – 주문 단가.

  • sll_buy_dvsn_cd (str) – 매도/매수 구분 코드. (01: 매도, 02: 매수)

  • rvse_cncl_dvsn_cd (str, optional) – 정정/취소 구분 코드. (00: 매도/매수 주문 시 필수, 02: 취소)

  • prdt_type_cd (str, optional) – 상품유형코드 (일본/홍콩/중국/베트남 인 경우만 사용)

  • rsvn_ord_rcit_dt (str, optional) – 예약 주문 접수 일자. (일본/홍콩/중국/베트남 인 경우만 사용)

  • ord_dvsn (str, optional) – 주문 구분 (미국 예약 매도 주문 시 사용, 00: 지정가, 31: MOO(시장가)).

  • ovrs_rsvn_odno (str, optional) – 해외 예약 주문 번호 (취소 시 사용).

Returns:

주문 접수에 대한 응답 정보.
  • rt_cd (str): 성공 여부 (0: 성공, 0 이외의 값: 실패).

  • msg_cd (str): 응답 코드.

  • msg1 (str): 응답 메시지.

  • output (dict): 응답 상세.
    • ODNO (str): 한국 거래소 전송 주문 조직 번호 (미국 예약 주문 시 출력).

    • RSVN_ORD_RCIT_DT (str): 예약 주문 접수 일자 (중국/홍콩/일본/베트남 예약 주문 시 출력).

    • OVRS_RSVN_ODNO (str): 해외 예약 주문 번호 (중국/홍콩/일본/베트남 예약 주문 시 출력).

Return type:

dict

Raises:

ValueError – 필수 인자가 없거나 잘못된 경우 발생.