inquire_balance#
- KISOverseasStock.inquire_balance(cano: str, acnt_prdt_cd: str, ovrs_excg_cd: str, tr_crcy_cd: str, ctx_area_fk200: str = '', ctx_area_nk200: str = '')[source]#
(해외주식주문) 해외주식 잔고조회[v1_해외주식-006]
해외주식 잔고를 조회하는 API 입니다.실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)* 미니스탁 잔고는 해당 API로 확인이 불가합니다.- Parameters:
cano (str) – 계좌번호
acnt_prdt_cd (str) – 계좌상품코드
ovrs_excg_cd (str) – 해외거래소코드
tr_crcy_cd (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
- output1: 응답상세1 (list)
cano: 계좌번호
acnt_prdt_cd: 계좌상품코드
prdt_type_cd: 상품유형코드
ovrs_pdno: 해외상품번호
ovrs_item_name: 해외종목명
frcr_evlu_pfls_amt: 외화평가손익금액
evlu_pfls_rt: 평가손익율
pchs_avg_pric: 매입평균가격
ovrs_cblc_qty: 해외잔고수량
ord_psbl_qty: 주문가능수량
frcr_pchs_amt1: 외화매입금액1
ovrs_stck_evlu_amt: 해외주식평가금액
now_pric2: 현재가격2
tr_crcy_cd: 거래통화코드 - HKD:홍콩달러 CNY:중국위안화 JPY:일본엔화 VND:베트남동
ovrs_excg_cd: 해외거래소코드 - NASD:나스닥 NYSE:뉴욕 AMEX:아멕스 SEHK:홍콩 SHAA:중국상해 SZAA:중국심천 TKSE:일본 HASE:하노이거래소 VNSE:호치민거래소
loan_type_cd: 대출유형코드 - 00:해당사항없음 01:자기융자일반형 03:자기융자투자형 05:유통융자일반형 06:유통융자투자형 07:자기대주 09:유통대주 11:주식담보대출 12:수익증권담보대출 13:ELS담보대출 14:채권담보대출 15:해외주식담보대출 16:기업신용공여 31:소액자동담보대출 41:매도담보대출 42:환매자금대출 43:매입환매자금대출 44:대여매도담보대출 81:대차거래 82:법인CMA론 91:공모주청약자금대출 92:매입자금 93:미수론서비스 94:대여
loan_dt: 대출일자
expd_dt: 만기일자
- output2: 응답상세2
frcr_pchs_amt1: 외화매입금액1
ovrs_rlzt_pfls_amt: 해외실현손익금액
ovrs_tot_pfls: 해외총손익
rlzt_erng_rt: 실현수익율
tot_evlu_pfls_amt: 총평가손익금액
tot_pftrt: 총수익률
frcr_buy_amt_smtl1: 외화매수금액합계1
ovrs_rlzt_pfls_amt2: 해외실현손익금액2
frcr_buy_amt_smtl2: 외화매수금액합계2
- Return type:
dict
- Raises:
ValueError – API 호출 실패시 발생