inquire_period_trade_profit#

KISDomesticStock.inquire_period_trade_profit(cano: str, acnt_prdt_cd: str, inqr_strt_dt: date, inqr_end_dt: date, sort_dvsn: str = '00', pdno: str = '', ctx_area_nk100: str = '', ctx_area_fk100: str = '', tr_cont: str = '')[source]#

(국내주식주문) 기간별매매손익현황조회[v1_국내주식-060]

기간별매매손익현황조회 API입니다.

한국투자 HTS(eFriend Plus) > [0856] 기간별 매매손익 화면 에서 “종목별” 클릭 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

Parameters:

  • cano (str) – 종합계좌번호

  • sort_dvsn (str) – 정렬구분 - 00:최근순(기본값) 01:과거순 02:최근순

  • acnt_prdt_cd (str) – 계좌상품코드

  • pdno (str) – 상품번호 - “” 공란입력 시, 전체 (기본값)

  • inqr_strt_dt (datetime.date) – 조회시작일자

  • inqr_end_dt (datetime.date) – 조회종료일자

  • ctx_area_nk100 (str) – 연속조회키100

  • ctx_area_fk100 (str) – 연속조회검색조건100

  • tr_cont (str) – 연속조회여부 - 공란:최초 조회시. ‘N’:연속조회시

Returns:

  • rt_cd (str): 응답코드

  • msg_cd (str): 메시지코드

  • msg1 (str): 응답메시지

  • output1 (dict): 응답상세1

    • trad_dt: 매매일자

    • pdno: 상품번호 - 종목번호(뒤 6자리만 해당)

    • prdt_name: 상품명

    • trad_dvsn_name: 매매구분명

    • loan_dt: 대출일자

    • hldg_qty: 보유수량

    • pchs_unpr: 매입단가

    • buy_qty: 매수수량

    • buy_amt: 매수금액

    • sll_pric: 매도가격

    • sll_qty: 매도수량

    • sll_amt: 매도금액

    • rlzt_pfls: 실현손익

    • pfls_rt: 손익률

    • fee: 수수료

    • tl_tax: 제세금

    • loan_int: 대출이자

    • ctx_area_fk100: 연속조회검색조건100

    • ctx_area_nk100: 연속조회키100 - 100

  • output2 (list): 응답상세2

    • sll_qty_smtl: 매도수량합계

    • sll_tr_amt_smtl: 매도거래금액합계

    • sll_fee_smtl: 매도수수료합계

    • sll_tltx_smtl: 매도제세금합계

    • sll_excc_amt_smtl: 매도정산금액합계

    • buyqty_smtl: 매수수량합계

    • buy_tr_amt_smtl: 매수거래금액합계

    • buy_fee_smtl: 매수수수료합계

    • buy_tax_smtl: 매수제세금합계

    • buy_excc_amt_smtl: 매수정산금액합계

    • tot_qty: 총수량

    • tot_tr_amt: 총거래금액

    • tot_fee: 총수수료

    • tot_tltx: 총제세금

    • tot_excc_amt: 총정산금액

    • tot_rlzt_pfls: 총실현손익

    • loan_int: 대출이자

    • tot_pftrt: 총수익률

Return type:

dict

Raises:

ValueError – API 에러 발생시

On this page
Show Source