schema_version: agents_rule.v1
rule_id: NO_KIS_ACCOUNT_BALANCE_QUERY_V1
title: KIS Open API로 계좌 보유종목/잔고 정보를 조회하지 않는다 — 필수 지침
priority: CRITICAL
origin: "사용자 직접 지시 (2026-06-21): 'OPEN API에 계좌 보유종목에 대한 정보는 사용하지
  않는다. 필수 지침이다.'"
has_code_implementation: true
code_path:
  - "src/quant_engine/kis_api_client_v1.py"
  - "tools/validate_no_direct_api_trading_v1.py"

summary:
  - "한국투자증권(KIS) Open API는 시세/호가/공매도/투자자매매동향 등 시장 전체에 공개된
    조회성 데이터 수집에만 사용한다. 계좌 보유종목·잔고·평가금액 조회(주식잔고조회 등)
    API는 호출하지 않는다."
  - "보유종목 정보의 유일한 출처(source of truth)는 기존 HTS 캡처 → ChatGPT 파싱 → GAS
    account_snapshot 시트 워크플로우다. 이 원칙은 [[feedback_direction_a_no_manual_input]]
    (positions 수동입력 금지)와 같은 계열의 데이터 출처 통제 규칙이며, KIS API가 그
    경로를 대체하거나 보강하지 않는다."
  - "이 규칙은 governance/rules/06_no_direct_api_trading.yaml(주문 미실행)과 별개의
    독립적인 제약이다 — 06번 규칙은 '쓰기(주문)'를 금지하고, 이 규칙은 '계좌 식별 데이터
    조회(읽기)'를 금지한다. 두 규칙 모두 충돌 없이 동시에 적용된다."

scope:
  prohibited_tr_ids:
    - "TTTC8434R"  # 주식잔고조회(실전)
    - "VTTC8434R"  # 주식잔고조회(모의)
  prohibited_path_substrings:
    - "/trading/inquire-balance"
  rationale: >
    이미 governance/rules/06의 FORBIDDEN_PATH_SUBSTRINGS=("/trading/",)가 이 경로를
    구조적으로 차단하지만(주식잔고조회도 /trading/ 하위 경로), 이 규칙은 그것이
    '주문 차단의 부수효과'가 아니라 '계좌정보 비조회'라는 독립적이고 의도적인 정책임을
    명시한다.

enforcement:
  code_level: "src/quant_engine/kis_api_client_v1.py에 inquire-balance 관련 함수를 작성하지
    않는다(함수 자체가 존재하지 않음). TTTC8434R/VTTC8434R을 FORBIDDEN_TR_ID_PREFIXES에
    추가해 2차 방어."
  test_level: "tests/unit/test_kis_api_client_v1.py — TTTC8434R/VTTC8434R 차단 검증 +
    tools/validate_no_direct_api_trading_v1.py 정적 스캔에 동일 TR_ID/경로 포함."

violation_consequence: "계좌 보유정보를 KIS API로 조회하면 HTS 캡처 기반 단일 진실원천
  원칙이 깨지고, 두 개의 서로 다른 보유종목 데이터 경로가 생겨 정합성 검증이 불가능해진다."
