# NoahAI Platform v3.9.0.4 공개 실행·위험관리 기준

기준일: 2026-07-30  
상태: 소스·문서 출시 후보  
현재 Windows 사용자 배포본: v3.9.0.2

## 제품 목적

NoahAI는 하나의 고정 전략을 강요하는 자동매매 프로그램이 아니라, 사용자가 이해하는 전략을 시장 데이터·실행 권한·위험관리·감사 가능한 기록에 연결하는 금융 의사결정 운영 계층을 지향한다.

AI 커스텀은 신규 사용자가 긴 학습 기간을 기다리지 않고 이동평균, 추세 추종, 눌림목, 평균회귀, 거래량 돌파, TradingView/Pine, 책·영상·문서 또는 직접 만든 전략을 구조화해 사용할 수 있게 한다. NoahAI 학습은 초기 사용의 전제조건이 아니라, 이후 전략과 국면의 적합성·비용·체결 품질·감독 품질을 개선하는 후행 기능이다.

이 구조는 수익이나 미래 성과를 보장하지 않는다.

## AI 커스텀의 두 실행 역할

### 일반 모드: NoahAI와 사용자 전략의 결합

1. 사용자 고정 종목과 NoahAI 자동 후보를 합친다.
2. 종목 데이터와 시장 국면을 분석한다.
3. NoahAI 기본 AI가 방향 후보를 만든다.
4. AI 커스텀 전략이 해당 후보를 정확히 한 번 확인한다.
5. 전략 조건이 맞으면 전략별 청산계획을 만들고, 아니면 HOLD한다.

일반 모드는 NoahAI의 자동 선정과 기본 판단을 유지하면서 익숙한 사용자 전략으로 후보를 재확인하는 권장 경로다.

### 고급 모드: 사용자 전략 원형 우선

1. 사용자 고정 종목과 전략별 `StrategyUniversePolicy`를 사용한다.
2. 거래소·증권사별 로컬 시장 데이터로 유동성·스프레드·변동성·이력 조건을 사전 필터링한다.
3. 사용자 전략의 지표와 진입·청산 조건을 계산한다.
4. 전략을 독립 후보로 정확히 한 번 평가한다.
5. NoahAI 기본 AI는 선택적 비교 기록만 만들 수 있고, 사용자 전략의 진입 동의 조건이 되지 않는다.

NoahAI는 고급 전략의 방향, 지표, 시간봉, 임계값, TP/SL, 청산·재진입 조건을 몰래 바꾸거나 기본값과 평균내지 않는다.

## 공통 실행 파이프라인

모든 가상자산 거래소와 증권사 경로는 다음 책임 순서를 공유한다.

1. 거래소·증권사 지원 유니버스 확인
2. 거래 가능 상태·유동성·스프레드·데이터 품질 검사
3. 일반 또는 고급 전략 경로 실행
4. 전략 출처·버전·국면·판단 근거가 있는 공통 `TradeCandidate` 생성
5. 전략별 `ExitPolicy`로 동적 진입·청산 계획 생성
6. 계좌 위험예산·집중도·최소 주문·수량 단위·중복 제출 검사
7. 같은 기회를 여러 거래소·증권사에서 실행할 정책 적용
8. LEARNING·PAPER·LIVE 실행 권한 확인
9. 주문 또는 가상 체결
10. 실시간 청산 감시·거래소 보험 주문·결과 기록

LEARNING은 전체 판단 파이프라인을 실행하고 근거를 기록하지만 외부 계정 상태 변경과 신규 주문 제출을 차단한다. PAPER는 같은 판단을 격리된 가상 잔고와 체결에 적용한다. LIVE는 사용자가 명시한 실제 주문 대상에서만 공통 안전 경계를 통과한 주문을 제출한다.

## 전략 무결성과 공통 위험관리

전략 무결성과 계좌·주문 안전은 서로 다른 책임이다.

- 전략 무결성: 방향, 지표, 시간봉, 임계값, TP/SL, 청산, 재진입, 허용 국면
- 공통 안전: 실행 권한, API 상태, 최소 주문·수량 단위, 중복 주문, 전체 손실·노출·집중도, 시세 이상, 주문 실패·부분 체결, 긴급 정지

전략의 손절거리가 계좌 위험예산을 넘으면 NoahAI가 손절거리를 임의로 좁히지 않는다. 요청한 손절거리를 유지한 채 주문 수량을 줄이고, 축소해도 안전한 실행이 불가능하면 주문을 차단한다. 화면과 로그에는 요청값, 허용값, 적용 수량과 차단 이유를 구분해 남긴다.

시장 국면 범위는 `market`, `symbol`, `both`, `none` 중 하나로 명시한다. 지정한 범위의 데이터가 없다고 다른 범위로 몰래 대체하지 않는다.

## 종목 선택과 다중 거래소·증권사 실행

각 거래소·증권사는 자기 지원 종목과 자기 시장 데이터로 후보를 만든다. Binance 종목 목록을 Bybit·OKX·Bitget·Upbit·Bithumb에 복사하지 않으며, 증권사도 각자 지원하는 주식·ETF 유니버스를 독립 평가한다.

`모든 거래소` 또는 `모든 증권사`는 모든 대상을 평가 범위로 허용한다는 뜻이다. 실제 주문은 사용자가 별도로 허용한 대상과 다음 실행 방식에 따른다.

- 각각 실행: 선택한 각 대상이 독립 검증을 통과하면 각 계좌에서 실행
- 총위험 분할: 하나의 기회에 배정한 총위험을 선택한 대상에 나누어 실행
- 우선순위 한 곳: 비용·우선순위 정책으로 선택한 한 대상에서 실행

Bitget과 OKX를 모두 실제 주문 대상으로 선택한 사용자가 양쪽에서 BTC를 거래하는 것은 중복 오류가 아니다. 두 실행은 하나의 BTC 기회 ID로 연결해 통합 노출·예상 손실·집중도·결과를 관리한다. 같은 거래소·계좌·신호의 재제출만 중복 주문으로 차단한다.

## 설명·기록 계약

화면과 로그는 최소한 다음을 구분한다.

- 기본 AI 판단
- AI 커스텀 역할과 결과
- 선택된 전략명·버전
- 최종 후보의 출처
- 시장 국면 범위와 적용 근거
- 적용된 위험예산과 주문 수량
- 동적 청산값
- 거래소에 제출한 보험 TP/SL
- 최종 허용 또는 차단 사유
- 다중 대상 실행 방식과 기회 ID

저장된 기본 TP/SL은 데이터가 부족할 때 사용하는 폴백이다. 현재 종목의 동적 청산값과 거래소에 실제 제출한 보험 주문값을 같은 값으로 오해하지 않도록 별도로 표시한다.

## AI 비용과 호출 원칙

거래소 지원 여부, 유동성, 스프레드, 변동성, 이력, 지표 계산과 고급 전략 유니버스 필터는 로컬 데이터로 처리한다. 후보 종목마다 불필요한 LLM 호출을 반복하지 않는다. 캐시는 데이터 시점·거래소·종목·작업 기준으로 사용하며, 오래된 캐시나 다른 거래소의 결과를 실제 주문 근거로 재사용하지 않는다.

## 공개 검증과 배포 경계

- v3.9.0.4 소스 전체 회귀: 1,219 passed, 6 skipped, 0 failed
- 설정 정본: v3.9.0.4, 기본 LEARNING, 템플릿 모순 0건
- 현재 Windows 사용자 배포본: v3.9.0.2
- 남은 게이트: Windows 빌드·서명·설치·자동업데이트·복원, 실제 Provider 키, 거래소·증권사별 최소 주문과 보호 주문, Kiwoom Windows OpenAPI+, 장시간 재시작·복구

자동 테스트 통과는 사용자별 API 권한·허용 IP·실제 체결 성공을 대신하지 않는다. Windows 실환경 게이트를 통과하기 전에는 v3.9.0.4를 사용자 배포 완료로 표현하지 않는다.