fix: 해외주식 모의투자 SELL TR_ID 오류 수정 VTTT1006U → VTTT1001U (#189) #190

agentson · 2026-02-21T03:12:14+09:00

agentson commented

2026-02-21 03:12:14 +09:00

문제

모든 해외주식 SELL 주문이 KIS API에서 거부됨:

모의투자에서는 해당업무가 제공되지 않습니다.

원인

src/broker/overseas.py:233에서 잘못된 TR_ID 사용:

# 수정 전 (잘못됨)
tr_id = "VTTT1002U" if order_type == "BUY" else "VTTT1006U"

VTTT1006U는 모의투자에 존재하지 않는 TR_ID.

근거

KIS 공식 문서 docs/한국투자증권_오픈API_전체문서_20260221_030000.xlsx — '해외주식 주문' 시트:

구분	TR_ID
모의투자 미국 매수	`VTTT1002U` ✅ (기존 정상)
모의투자 미국 매도	`VTTT1001U` ← 수정 필요

수정

# 수정 후 (올바름)
tr_id = "VTTT1002U" if order_type == "BUY" else "VTTT1001U"

향후 TR_ID 관리 규칙 (이번 PR에 함께 문서화)

⚠️ TR_ID는 반드시 공식 문서(docs/한국투자증권_오픈API_전체문서_*.xlsx)만 참조할 것.
커뮤니티/블로그 자료는 오래되거나 틀릴 수 있음.

docs/commands.md — "KIS API TR_ID 참조 문서" 섹션 추가
MEMORY.md — 에이전트 메모리에 공식 문서 참조 규칙 기록
src/broker/overseas.py — 코드 주석에 출처 명시

영향

해외주식 모의투자 SELL 주문이 정상 처리됨
손절/익절 실행 가능
테스트: test_sell_limit_order TR_ID assertion 함께 수정
731개 테스트 통과

Closes #189

## 문제 모든 해외주식 SELL 주문이 KIS API에서 거부됨: ``` 모의투자에서는 해당업무가 제공되지 않습니다. ``` ## 원인 `src/broker/overseas.py:233`에서 잘못된 TR_ID 사용: ```python # 수정 전 (잘못됨) tr_id = "VTTT1002U" if order_type == "BUY" else "VTTT1006U" ``` `VTTT1006U`는 모의투자에 존재하지 않는 TR_ID. ## 근거 KIS 공식 문서 `docs/한국투자증권_오픈API_전체문서_20260221_030000.xlsx` — '해외주식 주문' 시트: | 구분 | TR_ID | |------|-------| | 모의투자 미국 매수 | `VTTT1002U` ✅ (기존 정상) | | 모의투자 미국 매도 | `VTTT1001U` ← 수정 필요 | ## 수정 ```python # 수정 후 (올바름) tr_id = "VTTT1002U" if order_type == "BUY" else "VTTT1001U" ``` ## 향후 TR_ID 관리 규칙 (이번 PR에 함께 문서화) > ⚠️ TR_ID는 반드시 공식 문서(`docs/한국투자증권_오픈API_전체문서_*.xlsx`)만 참조할 것. > 커뮤니티/블로그 자료는 오래되거나 틀릴 수 있음. - `docs/commands.md` — "KIS API TR_ID 참조 문서" 섹션 추가 - `MEMORY.md` — 에이전트 메모리에 공식 문서 참조 규칙 기록 - `src/broker/overseas.py` — 코드 주석에 출처 명시 ## 영향 - 해외주식 모의투자 SELL 주문이 정상 처리됨 - 손절/익절 실행 가능 - 테스트: `test_sell_limit_order` TR_ID assertion 함께 수정 - 731개 테스트 통과 Closes #189

agentson added 2 commits 2026-02-21 03:12:14 +09:00

docs: 2026-02-21 요구사항 로그 업데이트 (#187 ) f2ad270e8b

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

fix: 해외주식 모의투자 SELL TR_ID 오류 수정 VTTT1006U → VTTT1001U (#189 )

CI / test (pull_request) Has been cancelled

Details

98071a8ee3

KIS 공식 문서(20260221) '해외주식 주문' 시트 확인 결과:
- 모의투자 미국 매수: VTTT1002U (기존 정상)
- 모의투자 미국 매도: VTTT1001U (기존 VTTT1006U → 잘못된 TR_ID)

VTTT1006U는 존재하지 않는 TR_ID로, 모든 해외 SELL 주문이
"모의투자에서는 해당업무가 제공되지 않습니다." 오류로 거부되었음.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

agentson added 1 commit 2026-02-21 03:14:02 +09:00

docs: KIS API TR_ID 공식 문서 참조 규칙 추가 (#189 )

CI / test (pull_request) Has been cancelled

Details

4b883a4fc4

docs/commands.md에 "KIS API TR_ID 참조 문서" 섹션 추가:
- 공식 문서 경로 명시: 한국투자증권_오픈API_전체문서_20260221_030000.xlsx
- 모의투자/실전투자 TR_ID 표 정리
- 비공식 자료(블로그 등) 사용 금지 경고
- 출처 주석 작성 가이드

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

jihoson merged commit 7dbc48260c into main

2026-02-21 03:14:34 +09:00

jihoson referenced this issue from a commit

2026-02-21 03:14:36 +09:00

Merge pull request 'fix: 해외주식 모의투자 SELL TR_ID 오류 수정 VTTT1006U → VTTT1001U (#189)' (#190) from feature/issue-189-overseas-sell-tr-id-fix into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#190