kispilot 0.1.0__py3-none-any.whl

kispilot/__init__.py

@@ -0,0 +1,3 @@
+"""KISPilot — 한국투자증권 Open API 를 AI 에이전트(MCP)와 웹 콘솔에서 쓰기 위한 도구 모음 (비공식)."""
+
+__version__ = "0.1.0"

kispilot/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from kispilot.cli import main
+
+sys.exit(main())

kispilot/api/__init__.py

@@ -0,0 +1 @@
+

kispilot/api/account/__init__.py

@@ -0,0 +1,24 @@
+"""계좌 단위(종목 개별이 아닌 계좌 전체) 조회 API 모음.
+
+    from kispilot.api.account import (
+        inquire_balance_rlz_pl, inquire_account_balance,
+        inquire_period_profit, inquire_period_trade_profit,
+        inquire_intgr_margin, inquire_period_rights,
+    )
+"""
+
+from .account_inquire_balance_rlz_pl import inquire_balance_rlz_pl
+from .account_asset_balance import inquire_account_balance
+from .account_inquire_period_profit import inquire_period_profit
+from .account_inquire_period_trade_profit import inquire_period_trade_profit
+from .account_intgr_margin import inquire_intgr_margin
+from .account_inquire_period_rights import inquire_period_rights
+
+__all__ = [
+    "inquire_balance_rlz_pl",
+    "inquire_account_balance",
+    "inquire_period_profit",
+    "inquire_period_trade_profit",
+    "inquire_intgr_margin",
+    "inquire_period_rights",
+]

kispilot/api/account/account_asset_balance.py

@@ -0,0 +1,130 @@
+# 투자계좌자산현황조회[v1_국내주식-048]
+from dataclasses import dataclass, field
+from typing import List, Optional
+
+from kispilot.api.config import DOMAIN, CANO, ACNT_PRDT_CD, REAL_APPKEY, REAL_APP_SECRET
+from kispilot.api.oauth.kis_token import load_token
+from kispilot.api.utils.http_session import get_session
+
+URL = "/uapi/domestic-stock/v1/trading/inquire-account-balance"
+# ※ 모의투자 미지원 (실전투자 전용).
+# ※ output1은 HTS(eFriend Plus) [0891] 계좌 자산비중(결제기준) 화면 아래 테이블과 동일.
+#   자산종류별로 고정된 순서(주식/펀드/채권/... /예수금/합계 등 최대 20개, 21번 계좌는 17개)로 내려온다.
+# ※ 응답 헤더에 tr_cont(F/M/D/E)가 있긴 하지만, 다음 페이지 요청에 필요한 CTX_AREA_FK100/NK100 같은
+#   연속조회 키 파라미터 자체가 Query Parameter에 없다. output1이 최대 20개로 고정된 목록이라
+#   실질적으로 연속조회가 필요 없는 것으로 보고, 페이지네이션 없이 1회 호출로 구현했다.
+# ※ INQR_DVSN_1, BSPR_BF_DT_APLY_YN은 문서상 "공란입력"이 고정값이라 파라미터로 노출하지 않는다.
+
+_TR_ID = "CTRP6548R"
+
+
+# ── DataClass 정의 ──────────────────────────────────────────
+
+@dataclass
+class ResponseBodyOutput1:
+    pchs_amt: Optional[str] = None          # 매입금액
+    evlu_amt: Optional[str] = None          # 평가금액
+    evlu_pfls_amt: Optional[str] = None     # 평가손익금액
+    crdt_lnd_amt: Optional[str] = None      # 신용대출금액
+    real_nass_amt: Optional[str] = None     # 실제순자산금액
+    whol_weit_rt: Optional[str] = None      # 전체비중율
+
+
+@dataclass
+class ResponseBodyOutput2:
+    pchs_amt_smtl: Optional[str] = None                     # 매입금액합계(유가매입금액)
+    nass_tot_amt: Optional[str] = None                       # 순자산총금액
+    loan_amt_smtl: Optional[str] = None                      # 대출금액합계
+    evlu_pfls_amt_smtl: Optional[str] = None                 # 평가손익금액합계
+    evlu_amt_smtl: Optional[str] = None                      # 평가금액합계(유가평가금액)
+    tot_asst_amt: Optional[str] = None                       # 총자산금액
+    tot_lnda_tot_ulst_lnda: Optional[str] = None              # 총대출금액총융자대출금액
+    cma_auto_loan_amt: Optional[str] = None                   # CMA자동대출금액
+    tot_mgln_amt: Optional[str] = None                        # 총담보대출금액
+    stln_evlu_amt: Optional[str] = None                       # 대주평가금액
+    crdt_fncg_amt: Optional[str] = None                       # 신용융자금액
+    ocl_apl_loan_amt: Optional[str] = None                    # OCL_APL대출금액
+    pldg_stup_amt: Optional[str] = None                       # 질권설정금액
+    frcr_evlu_tota: Optional[str] = None                      # 외화평가총액
+    tot_dncl_amt: Optional[str] = None                        # 총예수금액
+    cma_evlu_amt: Optional[str] = None                        # CMA평가금액
+    dncl_amt: Optional[str] = None                            # 예수금액
+    tot_sbst_amt: Optional[str] = None                        # 총대용금액
+    thdt_rcvb_amt: Optional[str] = None                       # 당일미수금액
+    ovrs_stck_evlu_amt1: Optional[str] = None                 # 해외주식평가금액1
+    ovrs_bond_evlu_amt: Optional[str] = None                  # 해외채권평가금액
+    mmf_cma_mgge_loan_amt: Optional[str] = None               # MMF·CMA담보대출금액
+    sbsc_dncl_amt: Optional[str] = None                       # 청약예수금액
+    pbst_sbsc_fnds_loan_use_amt: Optional[str] = None         # 공모주청약자금대출사용금액
+    etpr_crdt_grnt_loan_amt: Optional[str] = None             # 기업신용공여대출금액
+
+
+@dataclass
+class ResponseBody:
+    rt_cd: str                                                        # 성공 실패 여부
+    msg_cd: str                                                       # 응답코드
+    msg1: str                                                         # 응답메세지
+    output1: List[ResponseBodyOutput1] = field(default_factory=list)  # 자산종류별 현황(배열, 최대 20개)
+    output2: ResponseBodyOutput2 = field(default_factory=ResponseBodyOutput2)  # 계좌 자산 요약(단일)
+
+
+# ── 요청 함수 ───────────────────────────────────────────────
+
+def inquire_account_balance() -> ResponseBody:
+    """투자계좌 자산현황을 조회한다. (모의투자 미지원, 실전 계좌 전용)
+
+    HTS(eFriend Plus) [0891] 계좌 자산비중(결제기준) 화면과 동일한 데이터.
+    output1은 주식/펀드/채권/... /예수금/합계 등 자산종류별 현황이 고정된 순서로 최대 20개
+    (21번 계좌는 17개) 내려오고, output2는 계좌 전체의 자산/대출 요약이다.
+
+    Returns:
+        rt_cd/msg_cd/msg1과 자산종류별 현황(output1), 계좌 자산 요약(output2)을 담은 ResponseBody.
+    """
+    token = load_token("real")
+
+    headers = {
+        "content-type": "application/json; charset=utf-8",
+        "authorization": f"Bearer {token}",
+        "appkey": REAL_APPKEY,
+        "appsecret": REAL_APP_SECRET,
+        "tr_id": _TR_ID,
+        "custtype": "P",
+    }
+    params = {
+        "CANO": CANO,
+        "ACNT_PRDT_CD": ACNT_PRDT_CD,
+        "INQR_DVSN_1": "",
+        "BSPR_BF_DT_APLY_YN": "",
+    }
+    response = get_session().get(DOMAIN["real"] + URL, headers=headers, params=params, timeout=10)
+    raw = response.json()
+
+    # 에러 응답(rt_cd != "0")은 output1/output2 키가 없거나 null일 수 있어 안전 파싱.
+    # 문서 표기가 Output1/Output2(대문자)라 실제 JSON 키가 소문자일 가능성을 대비해 둘 다 확인한다.
+    fields1 = set(ResponseBodyOutput1.__dataclass_fields__)
+    raw_output1 = raw.get("output1") or raw.get("Output1") or []
+    output1 = [ResponseBodyOutput1(**{k: v for k, v in item.items() if k in fields1}) for item in raw_output1]
+
+    fields2 = set(ResponseBodyOutput2.__dataclass_fields__)
+    raw_output2 = raw.get("output2") or raw.get("Output2") or {}
+    output2 = ResponseBodyOutput2(**{k: v for k, v in raw_output2.items() if k in fields2})
+
+    return ResponseBody(
+        rt_cd=raw.get("rt_cd", ""),
+        msg_cd=raw.get("msg_cd", ""),
+        msg1=raw.get("msg1", ""),
+        output1=output1,
+        output2=output2,
+    )
+
+
+# ── 실행 ────────────────────────────────────────────────────
+
+if __name__ == "__main__":
+    result = inquire_account_balance()
+    if result.rt_cd != "0":
+        print(f"조회 실패: {result.msg_cd} - {result.msg1}")
+    else:
+        for row in result.output1:
+            print(row)
+        print(result.output2)

kispilot/api/account/account_inquire_balance_rlz_pl.py

@@ -0,0 +1,169 @@
+# 주식잔고조회_실현손익[v1_국내주식-041]
+from dataclasses import dataclass, field
+from typing import List, Literal, Optional
+
+from kispilot.api.config import DOMAIN, CANO, ACNT_PRDT_CD, REAL_APPKEY, REAL_APP_SECRET
+from kispilot.api.oauth.kis_token import load_token
+from kispilot.api.utils.http_session import get_session
+
+URL = "/uapi/domestic-stock/v1/trading/inquire-balance-rlz-pl"
+# ※ 모의투자 미지원 (실전투자 전용).
+# ※ order_inquire_balance.py(주식잔고조회)와 거의 같지만, output2에 실현손익 관련 필드
+#   (rlzt_pfls/rlzt_erng_rt/real_evlu_pfls/real_evlu_pfls_erng_rt)가 추가된 버전이다.
+# ※ CTX_AREA_FK100/NK100 쿼리 파라미터는 있지만, 응답 헤더 설명상 tr_cont로 다음 페이지를 이어받는
+#   연속조회는 지원하지 않는 API라서(항상 공란으로 보냄) 페이지네이션 없이 1회 호출로 끝난다.
+#   (요청 헤더 표에는 F/M/D/E 설명이 있지만, 응답 헤더 표는 "다음조회 불가 API"라고 명시돼 있어 후자를 따름.)
+
+_TR_ID = "TTTC8494R"
+
+
+# ── DataClass 정의 ──────────────────────────────────────────
+
+@dataclass
+class ResponseBodyOutput1:
+    pdno: Optional[str] = None                    # 상품번호(종목번호 뒤 6자리)
+    prdt_name: Optional[str] = None                # 상품명(종목명)
+    trad_dvsn_name: Optional[str] = None            # 매매구분명(매수/매도구분)
+    bfdy_buy_qty: Optional[str] = None              # 전일매수수량
+    bfdy_sll_qty: Optional[str] = None              # 전일매도수량
+    thdt_buyqty: Optional[str] = None               # 금일매수수량
+    thdt_sll_qty: Optional[str] = None              # 금일매도수량
+    hldg_qty: Optional[str] = None                  # 보유수량
+    ord_psbl_qty: Optional[str] = None              # 주문가능수량
+    pchs_avg_pric: Optional[str] = None             # 매입평균가격(매입금액/보유수량)
+    pchs_amt: Optional[str] = None                  # 매입금액
+    prpr: Optional[str] = None                      # 현재가
+    evlu_amt: Optional[str] = None                  # 평가금액
+    evlu_pfls_amt: Optional[str] = None             # 평가손익금액(평가금액-매입금액)
+    evlu_pfls_rt: Optional[str] = None              # 평가손익율
+    evlu_erng_rt: Optional[str] = None              # 평가수익율
+    loan_dt: Optional[str] = None                   # 대출일자
+    loan_amt: Optional[str] = None                  # 대출금액
+    stln_slng_chgs: Optional[str] = None            # 대주매각대금(신용거래 시 대부받은 주식의 매각대금)
+    expd_dt: Optional[str] = None                   # 만기일자
+    stck_loan_unpr: Optional[str] = None            # 주식대출단가
+    bfdy_cprs_icdc: Optional[str] = None            # 전일대비증감
+    fltt_rt: Optional[str] = None                   # 등락율
+
+
+@dataclass
+class ResponseBodyOutput2:
+    dnca_tot_amt: Optional[str] = None              # 예수금총금액
+    nxdy_excc_amt: Optional[str] = None             # 익일정산금액(D+1 예수금)
+    prvs_rcdl_excc_amt: Optional[str] = None        # 가수도정산금액(D+2 예수금)
+    cma_evlu_amt: Optional[str] = None               # CMA평가금액
+    bfdy_buy_amt: Optional[str] = None               # 전일매수금액
+    thdt_buy_amt: Optional[str] = None               # 금일매수금액
+    nxdy_auto_rdpt_amt: Optional[str] = None         # 익일자동상환금액
+    bfdy_sll_amt: Optional[str] = None               # 전일매도금액
+    thdt_sll_amt: Optional[str] = None               # 금일매도금액
+    d2_auto_rdpt_amt: Optional[str] = None           # D+2자동상환금액
+    bfdy_tlex_amt: Optional[str] = None              # 전일제비용금액
+    thdt_tlex_amt: Optional[str] = None              # 금일제비용금액
+    tot_loan_amt: Optional[str] = None               # 총대출금액
+    scts_evlu_amt: Optional[str] = None              # 유가평가금액
+    tot_evlu_amt: Optional[str] = None               # 총평가금액
+    nass_amt: Optional[str] = None                   # 순자산금액
+    fncg_gld_auto_rdpt_yn: Optional[str] = None      # 융자금자동상환여부
+    pchs_amt_smtl_amt: Optional[str] = None          # 매입금액합계금액
+    evlu_amt_smtl_amt: Optional[str] = None          # 평가금액합계금액
+    evlu_pfls_smtl_amt: Optional[str] = None         # 평가손익합계금액
+    tot_stln_slng_chgs: Optional[str] = None         # 총대주매각대금
+    bfdy_tot_asst_evlu_amt: Optional[str] = None     # 전일총자산평가금액
+    asst_icdc_amt: Optional[str] = None              # 자산증감액
+    asst_icdc_erng_rt: Optional[str] = None          # 자산증감수익율
+    rlzt_pfls: Optional[str] = None                  # 실현손익
+    rlzt_erng_rt: Optional[str] = None               # 실현수익율
+    real_evlu_pfls: Optional[str] = None             # 실평가손익
+    real_evlu_pfls_erng_rt: Optional[str] = None     # 실평가손익수익율
+
+
+@dataclass
+class ResponseBody:
+    rt_cd: str                                                        # 성공 실패 여부
+    msg_cd: str                                                       # 응답코드
+    msg1: str                                                         # 응답메세지
+    output1: List[ResponseBodyOutput1] = field(default_factory=list)  # 보유종목 목록(배열)
+    output2: List[ResponseBodyOutput2] = field(default_factory=list)  # 계좌 요약 + 실현손익(배열, 보통 원소 1개)
+
+
+# ── 요청 함수 ───────────────────────────────────────────────
+
+def inquire_balance_rlz_pl(
+    afhr_flpr_yn: Literal["N", "X", "Y"] = "N",
+    inqr_dvsn: Literal["00"] = "00",
+    fund_sttl_icld_yn: Literal["N", "Y"] = "N",
+    prcs_dvsn: Literal["00", "01"] = "00",
+    cost_icld_yn: Literal["Y", "N"] = "N",
+) -> ResponseBody:
+    """주식잔고(실현손익 포함)를 조회한다. (모의투자 미지원, 실전 계좌 전용)
+
+    한국투자 HTS(eFriend Plus) [0800] 국내 체결기준잔고 화면과 동일한 데이터.
+    order_inquire_balance.py와 달리 output2에 실현손익(rlzt_pfls 등) 필드가 있다.
+
+    Args:
+        afhr_flpr_yn: 시장 구분(AFHR_FLPR_YN). N KRX정규장종가 / X NXT / Y KRX+NXT 통합시세. 기본값 "N".
+        inqr_dvsn: 조회구분(INQR_DVSN). 00 전체(문서상 유일한 값).
+        fund_sttl_icld_yn: 펀드결제포함여부(FUND_STTL_ICLD_YN). N 포함하지 않음 / Y 포함. 기본값 "N".
+        prcs_dvsn: 처리구분(PRCS_DVSN). 00 전일매매포함 / 01 전일매매미포함. 기본값 "00".
+        cost_icld_yn: 비용포함여부(COST_ICLD_YN). Y 포함 / N 미포함. 기본값 "N".
+
+    Returns:
+        rt_cd/msg_cd/msg1과 보유종목 목록(output1), 계좌 요약+실현손익(output2)을 담은 ResponseBody.
+    """
+    token = load_token("real")
+
+    headers = {
+        "content-type": "application/json; charset=utf-8",
+        "authorization": f"Bearer {token}",
+        "appkey": REAL_APPKEY,
+        "appsecret": REAL_APP_SECRET,
+        "tr_id": _TR_ID,
+        "custtype": "P",
+    }
+    params = {
+        "CANO": CANO,
+        "ACNT_PRDT_CD": ACNT_PRDT_CD,
+        "AFHR_FLPR_YN": afhr_flpr_yn,
+        "OFL_YN": "",
+        "INQR_DVSN": inqr_dvsn,
+        "UNPR_DVSN": "01",
+        "FUND_STTL_ICLD_YN": fund_sttl_icld_yn,
+        "FNCG_AMT_AUTO_RDPT_YN": "N",
+        "PRCS_DVSN": prcs_dvsn,
+        "COST_ICLD_YN": cost_icld_yn,
+        "CTX_AREA_FK100": "",
+        "CTX_AREA_NK100": "",
+    }
+    response = get_session().get(DOMAIN["real"] + URL, headers=headers, params=params, timeout=10)
+    raw = response.json()
+
+    # 에러 응답(rt_cd != "0")은 output1/output2 키가 없거나 null일 수 있어 안전 파싱.
+    fields1 = set(ResponseBodyOutput1.__dataclass_fields__)
+    raw_output1 = raw.get("output1") or []
+    output1 = [ResponseBodyOutput1(**{k: v for k, v in item.items() if k in fields1}) for item in raw_output1]
+
+    fields2 = set(ResponseBodyOutput2.__dataclass_fields__)
+    raw_output2 = raw.get("output2") or []
+    output2 = [ResponseBodyOutput2(**{k: v for k, v in item.items() if k in fields2}) for item in raw_output2]
+
+    return ResponseBody(
+        rt_cd=raw.get("rt_cd", ""),
+        msg_cd=raw.get("msg_cd", ""),
+        msg1=raw.get("msg1", ""),
+        output1=output1,
+        output2=output2,
+    )
+
+
+# ── 실행 ────────────────────────────────────────────────────
+
+if __name__ == "__main__":
+    result = inquire_balance_rlz_pl()
+    if result.rt_cd != "0":
+        print(f"조회 실패: {result.msg_cd} - {result.msg1}")
+    else:
+        for row in result.output1:
+            print(row)
+        for row in result.output2:
+            print(row)

kispilot/api/account/account_inquire_period_profit.py

@@ -0,0 +1,198 @@
+# 기간별손익일별합산조회[v1_국내주식-052]
+from dataclasses import dataclass, field
+from typing import List, Literal, Optional
+
+from kispilot.api.config import DOMAIN, CANO, ACNT_PRDT_CD, REAL_APPKEY, REAL_APP_SECRET
+from kispilot.api.oauth.kis_token import load_token
+from kispilot.api.utils.http_session import get_session
+
+URL = "/uapi/domestic-stock/v1/trading/inquire-period-profit"
+# ※ 모의투자 미지원 (실전투자 전용).
+# ※ HTS(eFriend Plus) [0856] 기간별 매매손익 화면에서 "일별" 클릭 시와 동일한 데이터.
+# ※ output2의 총손익률(우측 하단 표시값)은 이 API가 아니라 기간별매매손익현황조회(TTTC8715R)의
+#   output2.tot_pftrt(총수익률)로 확인해야 한다 — 이 파일에는 없음(문서에 명시된 주의사항).
+# ※ 연속조회 지원: CTX_AREA_FK100/CTX_AREA_NK100이 실제 쿼리 파라미터에 있음(다른 계좌 API와 다름).
+
+_TR_ID = "TTTC8708R"
+
+
+# ── DataClass 정의 ──────────────────────────────────────────
+
+@dataclass
+class ResponseBodyOutput1:
+    trad_dt: Optional[str] = None       # 매매일자
+    buy_amt: Optional[str] = None       # 매수금액
+    sll_amt: Optional[str] = None       # 매도금액
+    rlzt_pfls: Optional[str] = None     # 실현손익
+    fee: Optional[str] = None           # 수수료
+    loan_int: Optional[str] = None      # 대출이자
+    tl_tax: Optional[str] = None        # 제세금
+    pfls_rt: Optional[str] = None       # 손익률
+    sll_qty1: Optional[str] = None      # 매도수량1
+    buy_qty1: Optional[str] = None      # 매수수량1
+
+
+@dataclass
+class ResponseBodyOutput2:
+    sll_qty_smtl: Optional[str] = None          # 매도수량합계
+    sll_tr_amt_smtl: Optional[str] = None       # 매도거래금액합계
+    sll_fee_smtl: Optional[str] = None          # 매도수수료합계
+    sll_tltx_smtl: Optional[str] = None         # 매도제세금합계
+    sll_excc_amt_smtl: Optional[str] = None     # 매도정산금액합계
+    buy_qty_smtl: Optional[str] = None          # 매수수량합계
+    buy_tr_amt_smtl: Optional[str] = None       # 매수거래금액합계
+    buy_fee_smtl: Optional[str] = None          # 매수수수료합계
+    buy_tax_smtl: Optional[str] = None          # 매수제세금합계
+    buy_excc_amt_smtl: Optional[str] = None     # 매수정산금액합계
+    tot_qty: Optional[str] = None               # 총수량
+    tot_tr_amt: Optional[str] = None            # 총거래금액
+    tot_fee: Optional[str] = None               # 총수수료
+    tot_tltx: Optional[str] = None              # 총제세금
+    tot_excc_amt: Optional[str] = None          # 총정산금액
+    tot_rlzt_pfls: Optional[str] = None         # 총실현손익
+    loan_int: Optional[str] = None              # 대출이자
+
+
+@dataclass
+class ResponseBody:
+    rt_cd: str                                                        # 성공 실패 여부
+    msg_cd: str                                                       # 응답코드
+    msg1: str                                                         # 응답메세지
+    output1: List[ResponseBodyOutput1] = field(default_factory=list)  # 매매일자별 손익(배열)
+    output2: ResponseBodyOutput2 = field(default_factory=ResponseBodyOutput2)  # 기간 합계(단일)
+
+
+# ── 요청 함수 ───────────────────────────────────────────────
+
+def _fetch_page(
+    inqr_strt_dt: str,
+    inqr_end_dt: str,
+    pdno: str,
+    sort_dvsn: str,
+    ctx_area_fk100: str,
+    ctx_area_nk100: str,
+    tr_cont: str,
+) -> tuple[ResponseBody, str, str, str]:
+    """기간별손익 일별합산 내역을 한 페이지만 조회한다.
+
+    Args:
+        inqr_strt_dt: 조회시작일자(INQR_STRT_DT), YYYYMMDD.
+        inqr_end_dt: 조회종료일자(INQR_END_DT), YYYYMMDD.
+        pdno: 상품번호(PDNO). 특정 종목만, 공란이면 전체.
+        sort_dvsn: 정렬구분(SORT_DVSN). 00/02 최근 순, 01 과거 순.
+        ctx_area_fk100: 연속조회검색조건100(CTX_AREA_FK100). 최초 조회는 "".
+        ctx_area_nk100: 연속조회키100(CTX_AREA_NK100). 최초 조회는 "".
+        tr_cont: 요청 헤더의 연속 거래 여부. 최초 조회는 "", 다음 페이지는 "N".
+
+    Returns:
+        (이번 페이지 ResponseBody, 응답 헤더의 tr_cont, 다음 페이지용 ctx_area_fk100, ctx_area_nk100).
+        응답 tr_cont가 "F" 또는 "M"이면 다음 페이지가 더 있다는 뜻이고, "D"/"E"면 마지막 페이지다.
+    """
+    token = load_token("real")
+    headers = {
+        "content-type": "application/json; charset=utf-8",
+        "authorization": f"Bearer {token}",
+        "appkey": REAL_APPKEY,
+        "appsecret": REAL_APP_SECRET,
+        "tr_id": _TR_ID,
+        "tr_cont": tr_cont,
+        "custtype": "P",
+    }
+    params = {
+        "ACNT_PRDT_CD": ACNT_PRDT_CD,
+        "CANO": CANO,
+        "INQR_STRT_DT": inqr_strt_dt,
+        "PDNO": pdno,
+        "CTX_AREA_NK100": ctx_area_nk100,
+        "INQR_END_DT": inqr_end_dt,
+        "SORT_DVSN": sort_dvsn,
+        "INQR_DVSN": "00",
+        "CBLC_DVSN": "00",
+        "CTX_AREA_FK100": ctx_area_fk100,
+    }
+    response = get_session().get(DOMAIN["real"] + URL, headers=headers, params=params, timeout=10)
+    raw = response.json()
+
+    # 에러 응답(rt_cd != "0")은 output1/output2 키가 없거나 null일 수 있어 안전 파싱.
+    fields1 = set(ResponseBodyOutput1.__dataclass_fields__)
+    raw_output1 = raw.get("output1") or []
+    output1 = [ResponseBodyOutput1(**{k: v for k, v in item.items() if k in fields1}) for item in raw_output1]
+
+    fields2 = set(ResponseBodyOutput2.__dataclass_fields__)
+    raw_output2 = raw.get("output2") or {}
+    output2 = ResponseBodyOutput2(**{k: v for k, v in raw_output2.items() if k in fields2})
+
+    body = ResponseBody(
+        rt_cd=raw.get("rt_cd", ""),
+        msg_cd=raw.get("msg_cd", ""),
+        msg1=raw.get("msg1", ""),
+        output1=output1,
+        output2=output2,
+    )
+
+    next_tr_cont = response.headers.get("tr_cont", "")
+    next_fk100 = raw.get("ctx_area_fk100", "") or ""
+    next_nk100 = raw.get("ctx_area_nk100", "") or ""
+
+    return body, next_tr_cont, next_fk100, next_nk100
+
+
+def inquire_period_profit(
+    inqr_strt_dt: str,
+    inqr_end_dt: str,
+    pdno: str = "",
+    sort_dvsn: Literal["00", "01", "02"] = "00",
+) -> ResponseBody:
+    """기간 내 매매일자별 손익 합산 내역을 전부 조회한다(연속조회 자동 처리). (모의투자 미지원, 실전 계좌 전용)
+
+    HTS(eFriend Plus) [0856] 기간별 매매손익 화면의 "일별" 탭과 동일한 데이터.
+
+    Args:
+        inqr_strt_dt: 조회시작일자, YYYYMMDD.
+        inqr_end_dt: 조회종료일자, YYYYMMDD.
+        pdno: 특정 종목코드만 조회할 때 지정. 기본값 "" (전체).
+        sort_dvsn: 정렬구분. "00"/"02" 최근 순, "01" 과거 순. 기본값 "00".
+
+    Returns:
+        rt_cd/msg_cd/msg1(마지막으로 받은 페이지 기준)과, 모든 페이지를 합친 매매일자별
+        손익(output1), 기간 합계(output2)를 담은 ResponseBody. 실패 여부는 반드시 rt_cd로 확인할 것.
+        (참고: 화면 우측 하단의 "총손익률"은 이 API가 아니라 기간별매매손익현황조회의
+        output2.tot_pftrt로 확인해야 한다.)
+    """
+    ctx_area_fk100 = ""
+    ctx_area_nk100 = ""
+    tr_cont = ""  # 공백: 최초 조회
+
+    all_output1: List[ResponseBodyOutput1] = []
+    body = ResponseBody(rt_cd="", msg_cd="", msg1="")
+
+    while True:
+        body, next_tr_cont, ctx_area_fk100, ctx_area_nk100 = _fetch_page(
+            inqr_strt_dt, inqr_end_dt, pdno, sort_dvsn,
+            ctx_area_fk100, ctx_area_nk100, tr_cont,
+        )
+        all_output1.extend(body.output1)
+
+        if body.rt_cd != "0" or next_tr_cont not in ("F", "M"):
+            break
+        tr_cont = "N"  # 다음 페이지 조회
+
+    return ResponseBody(
+        rt_cd=body.rt_cd,
+        msg_cd=body.msg_cd,
+        msg1=body.msg1,
+        output1=all_output1,
+        output2=body.output2,
+    )
+
+
+# ── 실행 ────────────────────────────────────────────────────
+
+if __name__ == "__main__":
+    result = inquire_period_profit(inqr_strt_dt="20260101", inqr_end_dt="20261231")
+    if result.rt_cd != "0":
+        print(f"조회 실패: {result.msg_cd} - {result.msg1}")
+    else:
+        for row in result.output1:
+            print(row)
+        print(result.output2)