inquire_period_profit#
- KISOverseasStock.inquire_period_profit(cano: str, acnt_prdt_cd: str, inqr_strt_dt: date, inqr_end_dt: date, wcrc_frcr_dvsn_cd: str, ovrs_excg_cd: str = '', crcy_cd: str = '', pdno: str = '', ctx_area_fk200: str = '', ctx_area_nk200: str = '')[source]#
(해외주식주문) 해외주식 기간손익[v1_해외주식-032]
해외주식 기간손익 API입니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)- Parameters:
cano (str) – 계좌번호
acnt_prdt_cd (str) – 계좌상품코드
inqr_strt_dt (dtm.date) – 조회시작일
inqr_end_dt (dtm.date) – 조회종료일
wcrc_frcr_dvsn_cd (str) – 외화통화구분코드 - 01:원화 02:외화
ovrs_excg_cd (str) – 해외거래소코드 - 공란:전체 NASD:미국 SEHK:홍콩 SHAA:중국 TKSE:일본 HASE:베트남
crcy_cd (str) – 통화코드 - 공란:전체 USD:미국달러 HKD:홍콩달러 CNY:중국위안화 JPY:일본엔화 VND:베트남동
pdno (str) – 상품번호 - 공란:전체
ctx_area_fk200 (str) – 연속조회검색조건200 - 초기조회 시 공백, 다음페이지 조회시 이전 조회 결과의 CTX_AREA_FK200값
ctx_area_nk200 (str) – 연속조회키200 - 초기조회 시 공백, 다음페이지 조회시 이전 조회 결과의 CTX_AREA_NK200값
- Returns:
rt_cd: 응답코드
msg_cd: 응답메시지코드
msg1: 응답메시지1
ctx_area_fk200: 연속조회검색조건200
ctx_area_nk200: 연속조회키200
tr_cont: 연속조회가능여부
- output1: 응답상세1 (list)
trad_day: 매매일
ovrs_pdno: 해외상품번호
ovrs_item_name: 해외종목명
slcl_qty: 매도청산수량
pchs_avg_pric: 매입평균가격
frcr_pchs_amt1: 외화매입금액1
avg_sll_unpr: 평균매도단가
frcr_sll_amt_smtl1: 외화매도금액합계1
stck_sll_tlex: 주식매도제비용
ovrs_rlzt_pfls_amt: 해외실현손익금액
pftrt: 수익률
exrt: 환율
ovrs_excg_cd: 해외거래소코드
frst_bltn_exrt: 최초고시환율
- output2: 응답상세 (dict)
stck_sll_amt_smtl: 주식매도금액합계 - WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고 OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우 출력값 무시
stck_buy_amt_smtl: 주식매수금액합계 - WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고 OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우 출력값 무시
smtl_fee1: 합계수수료1 - WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고 OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우 출력값 무시
excc_dfrm_amt: 정산지급금액 - WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고 OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우 출력값 무시
ovrs_rlzt_pfls_tot_amt: 해외실현손익총금액 - WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고 OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우 출력값 무시
tot_pftrt: 총수익률
bass_dt: 기준일자
exrt: 환율
- Return type:
dict
- Raises:
ValueError - API 호출 실패시 발생 –