← 블로그로 돌아가기

릴리즈 노트

NoahAI Labs 서비스 구조 변경 및 운영 정책 변경 기록

릴리즈 노트의 목적

이 릴리즈 노트는 기능 추가나 개선 사항을 나열하는 것이 아니라, 서비스 구조 변경과 운영 정책 변경을 기록하는 것을 목적으로 합니다.

각 버전에서 무엇이 바뀌었는지보다, 왜 그런 구조로 변경되었는지, 어떤 운영 원칙이 적용되었는지를 중심으로 기록합니다.

v3.8.9.9 — Binance Algo Order API 완전 구현 (2025-12-27)

구조 변경 배경

Binance 정책 변경(2025-12-09)으로 조건부 주문(TP/SL)이 Algo Service로 강제 분류되었습니다. 이는 단순한 기능 추가가 아니라, 거래소 API 정책 변화에 따른 운영 구조 재설계입니다.

운영 구조 변경

  • 서명 생성 규칙 통일: query string 기반 서명 생성으로 모든 파라미터를 일관된 방식으로 처리
  • 가격 정밀도 처리 표준화: tickSize 우선 적용, 부동소수점 오차 제거로 안정성 확보
  • 조건부 주문 분기 간소화: 복잡한 로직 제거(160줄 → 55줄)로 유지보수성 향상
  • 응답 형식 통일: Algo Order 응답을 일반 주문과 동일한 형식으로 변환하여 기존 코드와 호환성 유지

운영 원칙

거래소 정책 변경에 대응할 때는 기존 코드와의 호환성을 유지하면서 새로운 요구사항을 충족하는 구조로 변경합니다. 모든 모듈에 자동 적용되도록 설계하여 추가 수정을 최소화합니다.

v3.8.9.7 — Binance API 규칙 준수 및 설정 구조 개선 (2025-01-26)

구조 변경 배경

Binance API 공식 규칙을 완벽히 준수하고, 하드코딩된 설정을 사용자 제어 가능한 구조로 변경했습니다.

운영 구조 변경

  • API 규칙 준수: closePosition=True일 때 quantity 파라미터 제거, reduceOnly와 closePosition 동시 사용 금지
  • 설정 파일 구조화: 백업 TP/SL 설정을 settings.json으로 이동하여 AI가 시장 상황에 따라 자동 조정 가능
  • 경로 자동 감지: 하드코딩된 경로 제거, 패키지 환경에서도 올바른 경로 자동 감지
  • TP/SL 역할 명확화: 실시간 모니터링(주력)과 백업 TP/SL(보험) 역할 분리

운영 원칙

거래소 API 규칙은 절대적으로 준수하며, 사용자 제어 가능한 설정은 파일로 분리하여 AI가 동적으로 조정할 수 있도록 합니다.

v3.8.9.5 — TP/SL 검증 및 원자성 보장 강화 (2025-01-26)

구조 변경 배경

TP/SL 검증 실패 시에도 거래가 진행되는 문제를 해결하고,원자성 보장을 통해 안전성을 강화했습니다.

운영 구조 변경

  • TP/SL 필수 보장: 검증 실패 시 포지션 즉시 청산, 거래 실패로 처리
  • 원자성 보장: TP/SL 중 하나라도 실패 시 둘 다 롤백, 재설정 시에도 원자성 유지
  • 검증 로직 통일: 모든 검증 로직에서 동일한 주문 타입 필터링 사용
  • 모듈화 준비: TpSlManager 기반으로 TP/SL 관련 책임 집중, 재사용 가능한 구조

운영 원칙

안전장치(TP/SL)는 절대적으로 필수입니다. 설정되지 않으면 거래가 실행되지 않으며, 원자성 보장을 통해 부분 실패 상황을 방지합니다.

v3.8.9.3 — 통합잔고 및 거래통계 구조 개선 (2025-11-29)

구조 변경 배경

여러 거래소를 동시 운영할 때 통합 관리가 가능하도록 잔고와 거래 통계 구조를 개선했습니다.

운영 구조 변경

  • 통합잔고 합계 표시: 여러 거래소 USDT/KRW 잔고 합계 계산 및 표시
  • 거래통계 통합 조회: exchange_trade_stats 우선 조회, trade_log 폴백으로 정확도 향상
  • TP/SL 청산 기록: TP/SL 청산 시에도 trade_log 업데이트하여 통계 정확도 향상
  • 수수료 고려 청산: 수수료를 고려한 최소 수익 임계값으로 수수료 회수 보장

운영 원칙

다중 거래소 운영 시 통합 관점이 필수입니다. 개별 거래소뿐만 아니라 전체 자산과 성과를 한눈에 파악할 수 있어야 합니다.

v3.8.9.2 — 스마트 점진적 학습 시스템 (2025-11-29)

구조 변경 배경

신규 사용자와 기존 사용자 모두에게 적절한 조건을 적용하기 위해점진적 학습 시스템을 도입했습니다.

운영 구조 변경

  • 거래 이력 기반 임계값 조정: 전체 첫 거래(0회)부터 정상 거래(11회 이상)까지 단계적 완화
  • 코인별 첫 거래 처리: 새로운 코인 거래 시에도 완화된 임계값 적용
  • AI 종합 판단 신뢰: 약한 시그널이라도 시장 조건이 좋으면 AI 판단 존중
  • 시그널 강도별 조정: 시그널 강도에 따라 AI 신뢰도 자동 조정

운영 원칙

학습은 점진적으로 이루어집니다. 초기에는 완화된 조건으로 시작하고, 거래 이력이 쌓일수록 정상 임계값으로 전환합니다. AI의 종합 판단을 신뢰하여 시그널 강도만으로 판단하지 않습니다.

v3.8.9 — 포지션 동기화 시스템 강화 (2025-11-21)

구조 변경 배경

앱 재시작 후에도 정확한 상태를 유지하고, 실제 거래소와 메모리 상태를 동기화하는 구조를 강화했습니다.

운영 구조 변경

  • 실제 거래소와 메모리 동기화: 매 거래 사이클 시작 시 실제 포지션 조회
  • 청산된 포지션 자동 제거: 메모리 정리로 정확한 포지션 수 인식
  • 실제 포지션 자동 복구: 앱 재시작 대응으로 상태 유지
  • 거래 사이클 안정화: 포지션 수 정확한 인식으로 거래 루프 정상화

운영 원칙

메모리 상태는 항상 실제 거래소 상태와 일치해야 합니다. 동기화를 통해 앱 재시작이나 네트워크 오류 후에도 정확한 상태를 유지합니다.

v3.8.8.8 — 거래 차단 문제 해결 및 설정 보존 강화 (2025-11-14)

구조 변경 배경

첫 거래가 실행되지 않는 순환 문제(Chicken and Egg Problem)를 해결하고, 사용자 설정값이 영구 보존되도록 구조를 개선했습니다.

운영 구조 변경

  • 첫 거래 허용 로직: 전체 거래 이력이 0인 경우 완화된 조건 적용
  • 데이터 부족 시 임계값 완화: user_signal_threshold 기반 동적 조정
  • 설정값 보존 강화: 중첩 딕셔너리 재귀 처리로 2단계 이상 중첩도 완벽 처리
  • 보호된 설정 항목: 중요한 설정 항목 명시적 보호로 템플릿 병합 시에도 사용자 값 우선

운영 원칙

순환 문제는 구조적으로 해결해야 합니다. 첫 거래를 허용하여 데이터가 쌓이도록 하고, 사용자가 수정한 설정값은 항상 보존되어야 합니다.

v3.8.8.6 — Alpha Arena 모드 추가 (2025-11-07)

구조 변경 배경

LLM 기반 자율 거래 모드를 추가하여다양한 거래 전략을 지원하는 구조로 확장했습니다.

운영 구조 변경

  • 독립 거래 모드: 기존 자동매매 파이프라인과 완전 분리된 Alpha Arena 모드
  • LLM 기반 자율 거래: AI가 직접 거래 결정을 내리고 실행하는 구조
  • 검증된 전략 적용: Alpha Arena 벤치마크에서 검증된 승리 알고리즘 적용
  • 가드레일 자동 적용: 레버리지 범위, TP/SL 필수, 쿨다운 등 안전장치 내장

운영 원칙

새로운 거래 모드는 기존 시스템과 독립적으로 운영되며, 각 모드별로 적절한 가드레일이 자동 적용됩니다. 사용자가 선택한 모드에 따라 다른 전략이 적용됩니다.

v0.1 — 웹사이트 서비스 구조 공개 (2025-12)

서비스 페이지 구조 정리

NoahAI Labs 웹사이트의 서비스 영역을 다음과 같이 구조화했습니다:

  • Services (/product): 현재 사용 가능한 개인용 금융 AI 서비스에 집중
  • 자율형 금융 어시스턴트 (/product/assistant): 통합 재테크 / 금융 AI / 자율형 금융 어시스턴트의 상위 개념과 확장 비전
  • Technology (/technology): 금융 AI 엔진과 운영 스택 설명
  • Enterprise (/enterprise): B2B/기관용 운영 스택 설명

구조 변경의 이유

기존에는 코인 중심 서비스 설명에 집중되어 있었으나, NoahAI Labs가 지향하는 것은 특정 자산이 아닌 통합 금융 판단 AI입니다.

코인은 "최초의 실전 검증 자산"이라는 위치로만 언급하고, 전체 금융 AI의 확장 가능한 구조를 명확히 하기 위해 자율형 금융 어시스턴트 전용 페이지를 추가했습니다.

운영 원칙

  • 개별 코인 전략, 수익률 숫자, 단기 성과 강조를 하지 않습니다.
  • 판단 → 실행(선택적) → 기록 → 복기 → 설명(XAI) 구조를 중심으로 설명합니다.
  • 투자 자문·수익 보장 표현을 금지합니다.
  • 기술 과장 없이 '플랫폼', '엔진', '운영 구조' 같은 표현을 사용합니다.

향후 계획

향후 릴리즈 노트는 다음과 같은 구조 변경을 기록할 예정입니다:

  • 자산 범위 확장 (코인 → 증권/ETF/부동산)
  • 리스크 해석 능력 고도화
  • 판단 설명 범위 확대
  • 실행 범위 확장
  • 운영 정책 변경
  • 거래소 API 정책 변경 대응
  • 안전장치 구조 개선

기능 추가나 성과 숫자는 기록하지 않으며, 구조와 운영 원칙의 변경만 기록합니다.