From 64e4e32f9d7abf7082588b3c4c9a8c0d272762f6 Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Wed, 19 Aug 2026 13:12:59 +0900 Subject: [PATCH] docs: align venue defaults with SOR contract --- docs/interface-contract.md | 4 ++-- trex_core/adapters/broker/kis.py | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/interface-contract.md b/docs/interface-contract.md index e7d98d0..37f54fc 100644 --- a/docs/interface-contract.md +++ b/docs/interface-contract.md @@ -414,8 +414,8 @@ resume_kill_switch 요청·응답 (REQ-046): ### Additive Notes (REQ-117) -- `venue` 필드는 BAT-056에서 additive 추가. 기존 orb/tsl 미지정 호출 → 기본값 `"KRX"` 자동 적용 → 하위 호환. -- `OrderRequest`는 AMQP wire 위를 직접 흐르지 않는다. buy/sell intent의 선택적 `venue` 누락은 `SOR`이고, 명시한 KRX/NXT/SOR는 그대로 슬롯에 보존한다. `AUTO`와 그 밖의 값은 `invalid_venue`로 admission 전 거부한다. +- `venue` 필드는 BAT-056에서 additive 추가됐으며, 현재 계약에서 기존 orb/tsl을 포함한 미지정 호출은 `SOR`로 정규화한다. +- `OrderRequest`는 AMQP wire 위를 직접 흐르지 않는다. buy/sell intent의 선택적 `venue` 누락은 `SOR`이고, 명시한 KRX/NXT/SOR는 그대로 슬롯에 보존한다. 폐기된 `AUTO`와 그 밖의 값은 `invalid_venue`로 admission 전 거부한다. - KIS 어댑터는 KRX/NXT/SOR를 시간과 무관하게 보존해 `EXCG_ID_DVSN_CD`로 전송한다. - `OrderAck.venue`는 원주문 KRX/NXT/SOR를 `broker_order_id`와 함께 슬롯에 원자 저장하며 재시작·취소에 재사용한다. 실제 체결 거래소는 `FillStatus.execution_venue`의 KRX/NXT로 별도 전달해 outbox `venue`에 기록한다. SOR 또는 미지원 코드는 실제 거래소로 추론하지 않는다. diff --git a/trex_core/adapters/broker/kis.py b/trex_core/adapters/broker/kis.py index 8a9e824..69cfd88 100644 --- a/trex_core/adapters/broker/kis.py +++ b/trex_core/adapters/broker/kis.py @@ -273,8 +273,8 @@ class KISBroker: "ORD_DVSN": resolved_req.order_type, "ORD_QTY": str(resolved_req.qty), "ORD_UNPR": str(resolved_req.limit_price or 0), - # REQ-118: always send EXCG_ID_DVSN_CD from req.venue (default "KRX"). - # Previously omitted (server defaulted to KRX); explicit is more robust. + # The intent layer normalizes missing venue to SOR. The broker + # adapter always forwards the resulting explicit order venue. # Real-account NXT order confirmed rt_cd=0 on 2026-07-06. "EXCG_ID_DVSN_CD": actual_venue, }