v0.51.0 — 익일 결제 예정 건별 명세
get_account_balance에 view=settlement 모드를 추가했습니다 (키움 kt00008).
다음 결제일에 결제될 체결을 종목·수량·단가·수수료·제세금·정산금액으로 쪼개 보여줍니다 —
기존 summary의 D+1/D+2 추정예수금이 왜 그 값인지를 설명하는 드릴다운입니다.
tool 수는 50 그대로입니다. 새 축을 기존 tool의 모드로 붙이는 관례를 따랐습니다.
이 조회의 시점 규칙
체결 당일에는 0행이고 다음 영업일에야 잡힙니다. 8/13 체결분이 8/13에는 0행이었고
8/14에 2행으로 왔습니다. 빈 결과는 오류가 아니라 조회 시점 안내를 함께 냅니다.
코드로 못박은 함정
- 결제일은 키움이 준 값을 그대로 씁니다. 체결일+2영업일로 계산하면 어긋납니다 —
2026-08-13 체결의 결제일은 8/17이 아니라 8/18입니다(8/15 광복절이 토요일이라
8/17이 대체공휴일). - 정산금액은 매도(수취)·매수(지불)가 둘 다 양수로 옵니다. 부호로 방향을 읽으면
틀리므로 구분 열로 읽도록 각주를 달았습니다. - 제세금은 소득세·농어촌특별세·거래세·주민세 4갈래를 합산해 싣고 각주로 분해를 밝힙니다.
참고
지난 결제 내역 전체는 get_transactions(kt00015)를 쓰세요 — 이 모드는 다음 결제일
하루치만 보여줍니다. kt00015가 실전 전용(모의 미지원)인 것과 달리 이 모드는
모의투자에서도 동작합니다.