잔고·평가 요약¶
계좌 하나의 "총 평가금액 · 손익 · 종목별 보유" 를 한 화면으로. 쓰는 TR:
| TR | 메서드 | 쓰는 값 |
|---|---|---|
kt00018 계좌평가잔고내역요청 |
api.account.evaluation_balance_detail() |
합계(tot_pur_amt·tot_evlt_amt·tot_evlt_pl·tot_prft_rt) + 종목별 리스트 acnt_evlt_remn_indv_tot |
kt00001 예수금상세현황요청 |
api.account.deposit_detail() |
entr 예수금, d2_entra D+2 추정예수금, ord_alow_amt 주문가능금액 |
필드 이름·뜻은 공식 스펙 기준입니다 — 계좌 레퍼런스.
from kiwoom_client import KiwoomAPI, to_dataframe
from kiwoom_client.codes import Exchange
def num(value) -> float | int:
"""'+1,234' · '-000001234' · '12.34' 를 숫자로. 앞자리 0 채움도 금액으로 읽는다."""
text = str(value).replace(",", "").strip()
return float(text) if "." in text else int(text or 0)
api = KiwoomAPI.from_env(is_mock=True)
bal = api.account.evaluation_balance_detail(
qry_tp="1", # 1: 합산, 2: 개별
dmst_stex_tp=Exchange.KRX, # KRX / NXT
)
dep = api.account.deposit_detail(qry_tp="3") # 3: 추정조회, 2: 일반조회
print(f"총매입 {num(bal['tot_pur_amt']):>15,}원")
print(f"총평가 {num(bal['tot_evlt_amt']):>15,}원")
print(f"평가손익 {num(bal['tot_evlt_pl']):>15,}원 ({num(bal['tot_prft_rt'])}%)")
print(f"예수금 {num(dep['entr']):>15,}원 · D+2 {num(dep['d2_entra']):,}원 · "
f"주문가능 {num(dep['ord_alow_amt']):,}원")
holdings = to_dataframe(bal, key="acnt_evlt_remn_indv_tot", numeric=False)
if not holdings.empty:
amounts = ["rmnd_qty", "pur_pric", "cur_prc", "evlt_amt", "evltv_prft", "prft_rt"]
holdings[amounts] = holdings[amounts].apply(lambda col: col.map(num))
print(holdings[["stk_cd", "stk_nm", *amounts]]
.sort_values("evlt_amt", ascending=False).to_string(index=False))
to_number()·normalize()·to_dataframe()는 앞자리가 0 으로 채워진 문자열("005930")을 코드로 보고 문자열로 남깁니다. 금액 필드가 0 으로 채워져 와도 계산이 되게 여기서는num()으로 직접 바꿨습니다.- 보유 종목이 많으면 연속조회가 붙습니다 — 연속조회의 루프에
evaluation_balance_detail을 넣으면 됩니다. - 모의투자 서버가 지원하지 않는 TR 은
KiwoomUnsupportedError(키움 오류 8104)로 올라옵니다. - 조회 TR 은 주문을 내지 않지만, 실전 계좌를 볼 때는 키를 환경변수로만 넘기고 출력·로그에 계좌번호가 섞이지 않게 하세요.