auto: 일일 백업 2026-09-11 02:00

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/README.md

@@ -15,21 +15,25 @@ OpenClaw 워크스페이스에서 참조하는 외부 공급사·서비스·플
 
 - **공급사:** 키움증권
 - **용도:** 키움 OpenAPI(REST) 명세서. TR_ID 별 endpoint URL, request body·response field, 예시.
+- **버전:** 2026-09-10 사이트 다운로드본 (870쪽, API 347개 = OAuth 2 + 국내주식 210 + 미국주식 135). 직전본은 2026-05-07(528쪽·207개, 국내+OAuth만)
 - **관련 에이전트:** 레이(stock) — 매매·조회 모든 키움 호출의 단일 진실 공급원
-- **관련 코드:**
-  - `agents/stock/workspace/scripts/kiwoom_client.py` — 조회 전용 (kt00001/kt00004/kt00007/kt00018/ka10001/ka10099/ka10170)
-  - `agents/stock/workspace/scripts/orders/kiwoom_order.py` — 매수/매도 (kt10000/kt10001)
-  - `agents/stock/workspace/scripts/orders/datasource.py` — 호가(ka10004)
+- **관련 코드:** (실제 호출 TR)
+  - `scripts/kiwoom_client.py` — 조회 공용 클라이언트 (ka10001/ka10004/ka10023/ka10059/ka10075/ka10080/ka10081/ka10095/ka10099/ka10170/ka90009/kt00001/kt00004/kt00007/kt00015/kt00016/kt00018)
+  - `scripts/orders/kiwoom_order.py` — 매수/매도·정정·취소 (kt10000/kt10001/kt10002/kt10003), `orders/datasource.py` 호가(ka10004), `orders/guards.py`·`orders/handler.py`·`orders/fill_watcher.py` (ka10075/ka10099/kt00007)
+  - `scripts/realtime_hub.py` — WebSocket 실시간 (0B 주식체결 / 1h VI발동·해제)
+  - `scripts/investment_principal.py` (kt00015/kt00016/kt00018), `scripts/surge_monitor.py`·`scripts/trailing_monitor.py`, `sim/` (ka10023/ka10059/ka10081/ka90009)
 - **관련 메모리:**
-  - 코디: `~/.claude/projects/-Users-snowoyh--openclaw/memory/reference_kiwoom_endpoints.md`
+  - 코디: `~/.claude/projects/-Users-snowoyh--openclaw/memory/reference_kiwoom_endpoints.md`, `reference_kiwoom_doc_freshness_check.md`(최신성 대조법)
   - 레이: `agents/stock/workspace/memory/orders_module.md`, `2026-05-07-kiwoom-api-audit.md`
 - **새 TR 추가 절차:**
   1. PDF 목차에서 TR_ID 페이지 번호 확인
-  2. 해당 페이지에서 "URL" 필드 확인 → endpoint 결정 (`acnt`/`stkinfo`/`mrkcond`/`ordr`)
+  2. 해당 페이지에서 "URL" 필드 확인 → endpoint 결정 (`acnt`/`stkinfo`/`mrkcond`/`ordr`/`chart`/`rkinfo`)
   3. 응답 필드명 그대로 매핑 (suffix 패턴 추측 금지 — 2026-05-07 ka10004 사고)
   4. 가격·수량 필드는 `+/-` 부호 가능 — `abs()` 처리 검토
-- **마지막 검증:** 2026-05-07 — 10개 TR 코드 ↔ 명세 1:1 대조 완료
+- **최신성 확인:** 문서 안에 개정일자가 없다(jsPDF 클라이언트 생성물). 사이트 가이드 페이지를 GET으로 긁어 대조하는 절차는 코디 메모리 `reference_kiwoom_doc_freshness_check.md` 참조. 공식 PDF/JSON 다운로드 버튼은 WAF 차단이라 자동화 불가 — 갱신은 관리자님이 브라우저에서 직접
+- **마지막 검증:** 2026-09-10 — 사이트 목록 347개 ↔ PDF 수록 347개 전수 일치, 우리가 쓰는 21개 TR + 실시간 0B·1h 필드 대조 완료(구본 대비 변경은 kt00015 선택 파라미터 `qry_sort_tp` 추가 1건뿐)
 
 ## 변경 이력
 
 - 2026-05-07 — `docs/` 폴더 신규, 키움 REST API PDF 입주
+- 2026-09-10 — 키움 REST API PDF 갱신(2026-05-07 → 2026-09-10). 미국주식 135개 신규 수록, 국내 6개 추가·`ka10009` 삭제, `kt00015` 에 `qry_sort_tp` 추가. 기존 호출부 영향 없음