나스닥171819

Upload files online for free with no file size limit. Get a shareable link instantly, no signup required, with end-to-end encryption and auto-expiring files.

file.kiwi

# 전략 비교 대시보드 프로그램 설명서 및 사용 메뉴얼

Nov 12, 2026 · @조두루미

## 1. 프로그램 개요

이 프로그램은 야후 파이낸스의 분봉 데이터를 받아 전략 A(oMACD)와 전략 C(TFDir)의 매수·청산 신호와 성과를 한 화면에서 비교하고, 가상 자금으로 모의투자까지 할 수 있는 웹 대시보드 서버입니다. 브라우저에서 접속해 사용하며, 모든 매매는 가상 계좌에서만 이루어집니다.

**주요 기능**

- 종목별 가격 차트에 A-Fixed, A-Opt, C 전략의 매수(▲)·청산(▼) 신호 표시
- 전략별 누적 손익, 승률, 거래 수, Profit Factor, 최대 낙폭(MDD) 등 성과 표시
- 해외선물 방식(롱/숏, 증거금) 모의투자 계좌와 수동 주문
- 전략 신호가 바뀌면 알람과 확인 창을 띄우고, 사용자가 확인해야 체결되는 신호 알림
- 손절(STOP)·지정가 익절(LIMIT) 조건 청산 주문
- 저장된 캔들로 과거 시점의 차트·신호·성과를 재현하는 리플레이 모드
- 과거 신호가 재계산으로 바뀌지 않도록 고정하는 신호 고정 기능
- 화면 캡쳐(PNG)와 매매 기록 CSV 저장

**구성 요소**

| 구성 요소 | 역할 |
| --- | --- |
| server.js (Node.js + Express) | 웹 화면 제공, 야후 데이터 수신, 모의투자 계좌·알림·조건 주문 처리, 캔들 저장, API 제공 |
| strategy-core (Rust 실행파일) | 전략 A/C 신호와 성과 계산. server.js가 표준입력으로 JSON을 보내고 표준출력으로 결과를 받음 |
| 브라우저 화면 | Chart.js로 차트를 그리고 모의투자·알림·리플레이를 조작 |
| 데이터 파일 | 모의 계좌, 고정 신호, 원본 캔들을 JSON/JSONL 파일로 저장 |

## 2. 설치 및 실행

**필요한 것**

- Node.js (내장 fetch를 쓰므로 18 이상 권장)와 express 패키지 (`npm install express`)
- strategy-core 실행파일 (Windows는 strategy-core.exe). server.js와 같은 폴더에 두거나 환경변수 STRATEGY\_CORE로 경로를 지정
- 인터넷 연결 (야후 파이낸스 접속, 브라우저의 Chart.js·html2canvas CDN 로딩)

**실행 방법**

```
node server.js 8
```

마지막 숫자는 인스턴스 번호입니다. 포트는 8000 + 번호로 정해지므로 8이면 8008번 포트입니다. 번호를 생략하면 8이 기본값입니다. 브라우저에서 http://127.0.0.1:8008 로 접속합니다. pkg로 exe로 묶어도 동작하며, 이때 데이터 파일은 exe가 있는 폴더에 저장됩니다.

여러 번호로 동시에 실행하면 계좌·고정 신호 파일이 번호별로 분리되어 서로 다른 모의 계좌를 운영할 수 있습니다.

**환경변수**

| 이름 | 기본값 | 설명 |
| --- | --- | --- |
| PORT | 8000 + 인스턴스 번호 | 서버 포트 (지정하면 이 값이 우선) |
| HOST | 127.0.0.1 | 접속을 받을 주소. 같은 PC에서만 접속하도록 기본 설정됨 |
| STRATEGY\_CORE | 서버 폴더의 strategy-core | 전략 코어 실행파일 경로 |
| ALERT\_TTL\_MIN | 10 | 신호 알림 유효 시간(분). 지나면 자동 폐기 |
| FREEZE\_MARGIN\_MIN | 5 | 신호 고정 여유 시간(분) |
| REPLAY\_TICKERS | 없음 | 쉼표로 구분한 종목. 대시보드를 닫아도 3분마다 데이터를 수집 (예: NQ=F,SPY) |
| REPLAY\_CANDLE\_DIR | 서버 폴더의 replay\_candles | 원본 캔들 저장 폴더 |

**생성되는 데이터 파일** (번호는 인스턴스 번호)

| 파일 | 내용 |
| --- | --- |
| paper\_accountf번호.json | 모의 계좌(예수금, 포지션, 매매 기록, 자동 추종 설정, 조건 주문, 매매 시간 설정) |
| frozen\_signals\_f번호.json | 고정된 과거 신호 |
| replay\_candles/종목\_\_주기.jsonl | 리플레이용 원본 캔들 누적 저장 |

서버가 시작될 때 strategy-core를 찾지 못하면 콘솔에 경고가 출력됩니다. 이 경우 전략 계산이 모두 실패합니다.

## 3. 화면 구성

화면은 위에서 아래로 다음 영역으로 이루어져 있습니다. 신호 알림 카드는 화면 오른쪽 위에 고정되어 따로 뜹니다.

| 순서 | 영역 | 내용 |
| --- | --- | --- |
| 1 | 상단 컨트롤 | 종목 선택, 종목 추가·삭제, 새로고침, 화면 캡쳐, 매매 기록 저장, 신호기록 초기화 |
| 2 | 리플레이 패널 | 리플레이 모드 켜기/끄기, 재생 조작, 해당 시점까지의 모의 체결 표 |
| 3 | 전략 성과 카드 | A-Fixed, A-Opt, C의 누적 PnL, 승률, 거래 수 |
| 4 | 모의 투자 패널 | 계좌 요약, 수동 주문, 신호 알림 설정, 매매 시간 제한, 조건 청산 주문, 계좌 초기화, 보유 포지션·조건 주문·매매 기록 표 |
| 5 | 가격 차트 | 종가선과 A/C 신호 마커. 배경색·신호 표시를 체크박스로 선택 |
| 6 | oMACD 지표 차트 | A-Fixed와 A-Opt의 oMACD 선 |
| 7 | Equity 차트 | A-Fixed, A-Opt, C의 누적 성과 비교 |
| 8 | 전략 C 성과 패널 | C 전략 설정(진입·청산 TF, Data2, 데이터 구간·주기)과 상세 성과 지표 12개 |
| 9 | 전략 C 차트 3종 | 가격·신호 차트, 누적 손익 차트, 거래별 손익 막대 차트 |

**차트 색 규칙**

- A-Fixed: 파란색, A-Opt: 빨간색, C: 주황색 계열
- 가격 차트 배경: A-Fixed 보유 구간은 연한 파랑, A-Opt 보유 구간은 연한 빨강
- 전략 C 차트 배경: 롱 보유 구간은 청록, 대기 구간은 주황
- 모의 체결은 가격 차트에 ● 로 표시됩니다 (리플레이 중, 매수는 초록·매도는 빨강)

**자동 갱신**

- 전략 데이터: 3분마다 자동 새로고침
- 모의 계좌: 30초마다 갱신
- 신호 알림: 5초마다 서버에서 확인
- 조건 주문: 서버가 10초마다 확인

## 4. 전략 설명

세 전략의 신호 계산은 strategy-core가 수행하므로, 정확한 수식은 server.js에 없습니다. 아래는 server.js와 화면에서 확인되는 동작 기준의 설명입니다.

| 전략 | 설명 | 데이터 | 방향 |
| --- | --- | --- | --- |
| A-Fixed | oMACD 지표를 고정 파라미터로 계산한 전략 | 최근 3일 1분봉 중 최근 1000개 | 롱 |
| A-Opt | oMACD 파라미터를 최적화해 계산한 전략. 선택된 값이 지표 차트 범례에 20m/55m/800m 형태로 표시됨 | 최근 3일 1분봉 중 최근 1000개 | 롱 |
| C | 여러 타임프레임의 봉 방향(TFDir)과 oMACD를 조합한 전략 | 선택한 데이터 구간·봉 주기 (기본 3d / 1m) | 롱, 신호 알림에서는 롱/숏 전환 |

**전략 C의 진입·청산 조건**

- 진입: 진입 TF가 양봉이고, omacd가 0보다 크며, 종가와 저가가 상승
- 청산: 청산 TF로 체크한 타임프레임이 모두 음봉이고, omacd가 0보다 작음
- 성과 지표는 1단위 기준이며 수수료는 반영되지 않음

**전략 C 설정값**

| 설정 | 선택지 | 기본값 |
| --- | --- | --- |
| 진입 TF | 60, 120, 240, 360, 550, 720, 1440분 | 240분 |
| 청산 TF (복수 선택) | 위와 같음 | 60분, 120분, 240분 (저장된 설정이 없을 때 체크되는 값) |
| Data2(omacd) 주기 | 1, 5, 15, 30, 60, 120, 240, 360, 550, 720, 1440분 | 60분 |
| 데이터 구간 | 3d, 5d, 7d, 30d, 60d, 90d, 180d, 365d, 730d | 3d |
| 봉 주기 | 1m, 2m, 5m, 15m, 30m, 60m, 90m | 1m |

**야후 데이터 제한**: 봉 주기에 따라 가져올 수 있는 최대 기간이 정해져 있어, 선택한 주기가 허용하는 기간보다 길면 서버가 자동으로 허용되는 가장 긴 구간으로 줄입니다.

| 봉 주기 | 최대 구간 |
| --- | --- |
| 1m | 7일 |
| 2m, 5m, 15m, 30m, 90m | 60일 |
| 60m | 730일 |

## 5. 사용 메뉴얼

**5-1. 종목 선택과 관리**

1. 상단 "종목 선택" 드롭다운에서 종목을 고르면 해당 종목 데이터를 불러옵니다.
2. 새 종목은 티커 입력칸에 야후 파이낸스 티커를 입력하고 "종목 추가"를 누릅니다. 예: AAPL, NQ=F, BTC-USD, ^KS200
3. 현재 종목을 지우려면 "현재 종목 삭제"를 누릅니다. 종목은 최소 1개가 남아야 합니다.
4. 종목 목록은 브라우저(localStorage)에 저장되므로 다른 브라우저에서는 기본 목록이 보입니다.

**5-2. 새로고침과 자동 갱신**

- "새로고침" 버튼으로 즉시 다시 불러옵니다. 아무것도 누르지 않아도 3분마다 자동 갱신됩니다.
- 리플레이 모드 중에는 실시간 갱신이 멈춥니다.

**5-3. 신호와 배경색 표시**

- 가격 차트 위의 "배경색 표시"에서 A-Fixed(파랑), A-Opt(빨강) 보유 구간 색칠을 켜고 끕니다.
- "신호 표시"에서 A-Fixed, A-Opt, C의 마커를 각각 켜고 끌 수 있고, "전체 선택/전체 해제" 버튼도 있습니다. 선택 상태는 브라우저에 저장됩니다.
- 전략 C 차트의 "C 배경색 표시"로 롱 보유(청록)·대기(주황) 구간 색을 켜고 끕니다.

**5-4. 전략 C 설정 바꾸기**

1. 전략 C 성과 패널에서 진입 TF, 청산 TF(체크박스, 복수 선택), Data2 주기, 데이터 구간, 봉 주기를 고릅니다.
2. "적용"을 누르면 설정이 브라우저에 저장되고 즉시 다시 계산됩니다. 청산 TF는 1개 이상 선택해야 합니다.
3. 신호 알림에 쓰이는 C 설정은 "신호 알림 적용" 시점의 선택값입니다. 설정을 바꿨다면 알림 설정도 다시 적용하세요.

**5-5. 저장 기능**

| 버튼 | 결과 |
| --- | --- |
| 화면 캡쳐 | 대시보드 전체를 dashboard\_종목\_날짜.png 로 다운로드 |
| 매매 기록 저장 | 현재 화면 종목의 A-Fixed, A-Opt, C 전략 매매 기록을 trade\_history\_종목\_날짜.csv 로 저장 (전략, 티커, 진입·청산 시간, 수익금) |
| 모의 매매 기록 저장 | 모의투자 체결 기록을 paper\_trades\_날짜.csv 로 저장 |
| 신호기록 초기화 | 현재 종목의 고정된 과거 신호 기록을 지우고 다시 계산 (10장 참고) |

## 6. 모의투자 메뉴얼

모의투자는 가상 자금으로 해외선물처럼 롱·숏을 모두 거래하는 기능입니다. 기본 초기 자금은 100,000, 기본 증거금률은 10%입니다. 체결가는 항상 해당 종목의 최신 1분봉 종가입니다 (가격은 15초 동안 캐시됨).

**계좌 요약 항목**

| 항목 | 의미 |
| --- | --- |
| 예수금 | 초기 자금에 실현 손익만 반영한 금액 |
| 총 자산 | 예수금 + 평가 손익 |
| 사용 증거금 | 보유 포지션별 (수량 × 평균단가 × 증거금률) 합계 |
| 주문 가능 | 총 자산 − 사용 증거금 |
| 실현 손익 | 청산으로 확정된 손익 누계 |
| 평가 손익 | 보유 포지션의 현재가 기준 미실현 손익 |
| 총 수익률 | 총 자산이 초기 자금 대비 얼마나 늘었는지 (%) |

**수동 주문 방법**

1. 현재 종목과 현재가를 확인합니다.
2. 수량을 입력합니다 (소수점 4자리까지).
3. "매수 (롱)"은 롱 진입 또는 숏 청산, "매도 (숏)"은 숏 진입 또는 롱 청산입니다.
4. "전량 청산"은 현재 종목의 보유 포지션을 반대 주문으로 모두 정리합니다.

**체결 규칙**

- 반대 방향 주문 수량이 보유량보다 크면, 보유분을 청산하고 남은 수량으로 반대 포지션을 새로 엽니다 (예: 롱 1 보유 중 매도 3 → 롱 청산 후 숏 2).
- 같은 방향 추가 주문은 평균단가를 가중평균으로 다시 계산합니다.
- 일부만 청산하면 남은 포지션의 평균단가는 그대로입니다.
- 새로 여는 수량의 증거금이 부족하면 "증거금이 부족합니다." 오류로 거부됩니다. 청산 주문은 증거금과 상관없이 가능합니다.
- 수동 주문은 매매 시간 제한(7장)의 영향을 받지 않습니다.

**계좌 초기화**

초기 자금과 증거금률(%)을 입력하고 "계좌 초기화"를 누르면 포지션, 매매 기록, 신호 알림 설정, 조건 주문이 모두 삭제되고 새 계좌가 만들어집니다. 되돌릴 수 없습니다. 매매 시간 설정만 유지됩니다.

**매매 기록 표**

최근 300건이 최신순으로 표시되고, 출처 칸에 수동 / 신호확인(전략명) / 손절(STOP) / 지정가(LIMIT) 중 하나가 표시됩니다.

## 7. 신호 알림, 수동 확인 체결, 매매 시간 제한

전략 신호가 바뀌어도 주문이 자동으로 나가지 않습니다. 서버가 "확인 대기 알림"만 만들고, 사용자가 화면에서 \[확인 (체결)\]을 눌러야 최신가로 체결됩니다.

**7-1. 설정 방법**

1. 모의투자 패널의 "신호 알림" 줄에서 전략을 고릅니다 (A-Fixed, A-Opt, C).
2. 방향을 고릅니다. "신호 구간 롱"은 신호가 켜지면 매수, "신호 구간 숏 (역추종)"은 신호가 켜지면 매도합니다.
3. 신호당 주문 수량을 입력하고 "적용"을 누릅니다. 끄려면 "사용 안 함"을 선택하고 적용합니다.
4. 적용 직후 첫 평가는 현재 상태를 기준으로만 기록하고 알림을 만들지 않습니다. 이후 신호가 바뀔 때부터 알림이 생깁니다.

종목마다 하나의 전략만 설정할 수 있고, 설정한 종목은 대시보드를 닫아 두어도 서버가 3분마다 다시 평가합니다.

**7-2. 알림이 만들어지는 경우**

| 전략 | 알림 시점 | 제안 주문 |
| --- | --- | --- |
| A-Fixed, A-Opt | 미보유 → 보유 신호로 바뀔 때 | 진입 주문 (롱이면 매수, 숏이면 매도) |
| A-Fixed, A-Opt | 보유 → 미보유 신호로 바뀔 때 | 신호로 진입해 둔 수량만큼 청산. 해당 포지션이 없으면 주문 없는 참고용 알림 |
| C | 롱 / 대기 / (역추종 시 숏) 상태가 바뀔 때 | 기존 신호 포지션 청산 + 새 방향 진입 |

같은 종목·전략의 이전 대기 알림은 새 신호가 생기면 대체됩니다.

**7-3. 알림 카드 사용법**

- 화면 오른쪽 위에 카드가 뜨며, 신호 시각, 신호 가격, 현재가, 제안 주문이 표시됩니다.
- "확인 (체결)"을 누르면 현재 최신가로 제안 주문이 체결됩니다.
- "무시"를 누르면 체결 없이 삭제됩니다. 주문이 없는 참고용 알림은 "확인"으로 닫습니다.
- 알림은 10분(ALERT\_TTL\_MIN)이 지나면 자동 폐기되고, 확인하려 해도 "신호가 오래되어" 오류가 납니다.
- 전략 C 카드에는 선택한 각 타임프레임의 현재 봉 방향(양봉/음봉)이 함께 표시됩니다. 체결 직전에 서버가 조건을 다시 검사하여, 신호가 이미 해제됐으면 체결하지 않고 알림을 삭제합니다.

**7-4. 알람 소리**

- 알림에 해당하는 신호 마커가 현재 화면 차트에 실제로 표시됐을 때만 소리가 납니다. 카드에 "차트에 신호 표시 확인됨"이 뜨면 확인된 것입니다.
- 마커가 아직 없으면 카드에 대기 문구가 뜨고, 차트가 해당 종목이면 20초 간격으로 최대 3회 자동으로 차트를 다시 불러옵니다.
- 알림이 다른 종목이면 그 종목을 차트에서 선택해야 소리가 납니다. 리플레이 중에는 울리지 않습니다.
- 처리하지 않은 알림은 8초마다 소리가 반복됩니다. 매수는 올라가는 3음, 매도는 내려가는 3음입니다.
- "알람 소리 켜짐/꺼짐" 버튼으로 소리를 끄고 켜고, "소리 테스트"로 확인합니다. 브라우저 정책상 페이지에서 한 번은 클릭해야 소리가 납니다.

**7-5. 매매 시간 제한**

- "매매 시간 제한"을 체크하고 시작·종료 시각(KST)을 정한 뒤 "적용"합니다. 기본 입력값은 22:30 \~ 다음날 11:00이며, 시작이 종료보다 늦으면 자정을 넘기는 구간으로 처리됩니다.
- 허용 시간 밖에서는 알림이 만들어지지 않고 소리도 나지 않으며, 알림 확인 체결도 거부됩니다. 신호 상태 추적은 계속됩니다.
- 수동 주문과 조건 청산 주문(8장)에는 적용되지 않습니다.
- 체크를 끄면 24시간 제한이 없습니다. 상태는 입력칸 옆에 "지금 매매 가능 시간" 또는 "지금은 매매 시간 아님"으로 표시됩니다.

## 8. 조건 청산 주문 (손절 / 지정가 익절)

보유 중인 포지션이 지정한 가격에 닿으면 자동으로 청산하는 보호 주문입니다. 서버가 10초마다 확인하며, 대시보드를 닫아 두어도 동작하고 매매 시간 제한과 상관없이 항상 작동합니다. 체결가는 현재가가 아니라 지정한 가격입니다.

**등록 방법**

1. 보유 포지션이 있는 종목을 차트에서 선택합니다. 포지션이 없으면 등록할 수 없습니다.
2. 유형(손절 STOP / 지정가 익절 LIMIT), 가격, 수량을 입력합니다. 수량을 비우면 전량입니다.
3. "등록"을 누르면 "조건 청산 주문 (대기 중)" 표에 나타납니다. 취소는 표의 "취소" 버튼입니다.

**가격 입력 규칙**

| 보유 방향 | 손절 (STOP) | 지정가 익절 (LIMIT) |
| --- | --- | --- |
| 롱 | 현재가보다 낮은 가격 (가격이 내려와 닿으면 매도) | 현재가보다 높은 가격 (올라가 닿으면 매도) |
| 숏 | 현재가보다 높은 가격 (올라가 닿으면 매수) | 현재가보다 낮은 가격 (내려와 닿으면 매수) |

규칙에 맞지 않는 가격은 "현재가보다 낮아야/높아야 합니다" 오류로 거부됩니다. 수량이 보유 수량보다 크면 등록되지 않습니다.

**동작 방식**

- 등록 이후의 1분봉 고가·저가로 판정하므로, 확인 주기 사이에 잠깐 스친 가격도 놓치지 않습니다. 등록한 그 분봉은 종가만 사용합니다.
- 체결되면 화면에 "손절(STOP) 체결" 같은 확인 카드가 뜨고, 알림음이 울립니다. 카드의 "확인"을 눌러 닫습니다.
- 포지션이 사라지거나 방향이 바뀌면 남은 조건 주문은 자동 취소됩니다.
- 지정한 수량이 보유량보다 줄어든 경우 보유량만큼만 청산됩니다.

## 9. 리플레이 모드

리플레이는 서버에 저장된 원본 캔들을 특정 과거 시점까지만 잘라 전략을 다시 계산해, 그 시점의 차트·신호·성과 화면을 그대로 재현하는 기능입니다. 영상처럼 재생하며 전략이 당시에 어떻게 반응했는지 볼 수 있습니다.

**캔들 저장 방식**

- 대시보드가 데이터를 불러올 때마다 1분봉과 C 전략용 봉이 종목·주기별 파일(replay\_candles 폴더)에 누적 저장됩니다.
- 서버가 켜져 있던 기간의 데이터만 재생할 수 있습니다. 대시보드를 닫아도 계속 쌓으려면 REPLAY\_TICKERS 환경변수에 종목을 지정합니다 (3분마다 수집).
- 해당 시점 이전에 1분봉이 200개 이상 저장되어 있어야 재생할 수 있습니다.

**사용 방법**

1. "리플레이 모드" 버튼을 누르면 조작 패널이 열리고 실시간 자동 갱신이 멈춥니다.
2. "구간"(최근 6·12·24시간, 3일, 저장된 전체)과 "프레임 간격"(1·3·5·15·30·60분)을 고릅니다. 바꾸면 시점 목록이 다시 만들어지고 마지막 프레임으로 이동합니다.
3. ⏮ / ⏭ 로 한 프레임씩 이동하거나, ▶ 재생으로 자동 재생합니다. 재생 속도는 느리게(2초), 보통(1초), 빠르게(0.4초), 최대 속도 중에서 고릅니다.
4. 슬라이더를 끌어 원하는 시점으로 바로 이동합니다. 놓으면 그 시점을 계산합니다.
5. 화면 제목에 현재 재생 중인 시점(KST)이 표시되고, 아래 상태줄에 서버 계산 시간과 사용한 1분봉 개수가 나옵니다.
6. "리플레이 종료 (실시간으로)"를 누르면 실시간 화면으로 돌아갑니다.

**참고**

- 종목을 바꾸거나 전략 C 설정을 "적용"하면 리플레이 상태에서 다시 계산됩니다.
- 해당 시점까지의 모의 체결이 표로 표시되고, 가격 차트에 ● 로 겹쳐 표시됩니다.
- 리플레이 계산은 모의투자 신호 알림과 자동 추종을 호출하지 않으므로, 실제 계좌나 알림에 영향을 주지 않습니다.
- 이미 지난 시점의 계산 결과는 서버에 최대 60개까지 캐시되어 다시 볼 때 빠릅니다.
- 진행 중이던 상위 주기 봉은 1분봉으로 부분 재구성하여 당시 화면과 같게 보여줍니다.

## 10. 신호 고정 기능

서버는 매번 최근 1000개 봉을 새로 잘라 전략 A를 계산하므로, 구간이 한 칸씩 밀리면 과거 신호가 달라 보일 수 있습니다. 신호 고정은 이미 확정된 과거 신호를 저장해 두었다가, 새로 계산해도 그대로 보여 주는 기능입니다.

**동작 방식**

- 최신 봉에서 5분(FREEZE\_MARGIN\_MIN)보다 오래된 신호는 저장본을 그대로 쓰고, 그 이내의 미확정 구간만 이번 계산값으로 갱신합니다.
- 대상은 A-Fixed와 A-Opt의 매수·청산 신호, 그리고 두 전략의 포지션 배경 구간입니다. 전략 C 신호는 고정 대상이 아닙니다.
- 종목별로 frozen\_signals\_f번호.json 에 저장되며, 처음 불러올 때는 그 시점의 계산값이 그대로 저장됩니다.
- 성과 카드, Equity 차트, 매매 기록, 신호 알림과 자동 추종은 고정과 무관하게 항상 최신 계산값을 씁니다. 그래서 차트 신호와 성과 숫자가 서로 다르게 보일 수 있습니다.
- 리플레이 계산에는 적용되지 않습니다.

**초기화**

"신호기록 초기화" 버튼은 현재 종목의 고정 기록을 지우고 처음부터 다시 계산합니다. 전략 설정이나 코어(strategy-core)를 바꾼 뒤 과거 신호를 새 기준으로 보고 싶을 때 사용합니다.

## 11. API 목록 (개발자용)

오류가 나면 HTTP 400(요청 오류) 또는 500(서버 오류)과 함께 {"detail": "메시지"} 형식으로 응답합니다.

| 메서드·경로 | 입력 | 설명 |
| --- | --- | --- |
| GET / | - | 대시보드 화면 |
| GET /api/strategy-data | ticker, ctf, crange, cint, cen, cd2 | 전략 A/C 신호·성과·차트 데이터. 호출 시 캔들 저장과 자동 추종 평가도 함께 수행 |
| GET /api/paper/account | ticker(선택) | 계좌 요약, 포지션, 매매 기록, 조건 주문, 선택 종목 현재가 |
| POST /api/paper/order | ticker, side(BUY/SELL), qty | 최신가로 수동 주문 체결 |
| POST /api/paper/auto | ticker, strategy(A-Fixed/A-Opt/C/OFF), direction, qty, tfs, cen, cd2, crange, cint | 종목별 신호 알림 설정 |
| GET /api/paper/alerts | - | 대기 중 알림, 체결 알림(notices), 매매 시간 상태 |
| POST /api/paper/alert/confirm | id | 알림의 제안 주문을 최신가로 체결 |
| POST /api/paper/alert/dismiss | id | 알림을 체결 없이 삭제 |
| POST /api/paper/cond | ticker, type(STOP/LIMIT), price, qty | 조건 청산 주문 등록 |
| POST /api/paper/cond/cancel | id | 조건 청산 주문 취소 |
| POST /api/paper/notice/ack | id | 조건 주문 체결 알림 닫기 |
| POST /api/paper/window | enabled, start, end | 매매 시간 제한 설정 (HH:MM, KST) |
| POST /api/paper/reset | cash, marginRate | 모의 계좌 초기화 (marginRate는 0\~1 비율) |
| GET /api/replay2/times | ticker, hours, step | 재생 가능한 시점 목록 |
| GET /api/replay2/frame | ticker, at, ctf, crange, cint, cen, cd2 | 특정 시점의 전략 데이터 재현 |
| GET /api/replay2/status | - | 캔들 저장 현황 |
| POST /api/signals/freeze/reset | ticker(생략 시 전체) | 고정 신호 기록 초기화 |

**참고**

- ctf는 쉼표로 구분한 청산 타임프레임(예: 60,120,240), cen은 진입 TF, cd2는 Data2 주기, crange·cint는 C 전략 데이터 구간·봉 주기입니다.
- 허용 목록에 없는 값은 기본값으로 대체됩니다.
- 시간 값은 한국시간(KST)으로 +9시간 보정된 값이라, 화면 라벨은 UTC 표기처럼 보여도 실제로는 KST입니다.

## 12. 주의사항, 한계, 문제 해결

**주의사항과 한계**

- 모든 매매는 가상 계좌에서만 이루어지며 실제 주문이 나가지 않습니다. 수수료와 슬리피지는 반영되지 않으므로 실제 성과와 차이가 납니다.
- 가격 데이터는 야후 파이낸스의 비공식 차트 API입니다. 지연, 누락, 일시적 접속 실패가 있을 수 있고, 종목 휴장 중에는 마지막 가격이 쓰입니다.
- 서버에는 로그인이 없고 모든 출처의 접속(CORS)을 허용합니다. 기본값(HOST=127.0.0.1)은 같은 PC에서만 접속되게 막으므로, HOST를 바꿔 외부에 열 경우 누구나 계좌를 조작할 수 있다는 점을 유의하세요.
- 전략 C의 성과 패널은 롱 전용으로 계산되어 숏 손익은 항상 0으로 표시됩니다. 신호 알림에서의 숏 전환은 모의 계좌에만 적용됩니다.
- 이 프로그램의 신호와 성과는 투자 권유가 아닙니다. 투자 판단과 책임은 사용자에게 있습니다.
- 서버를 끄면 신호 알림 평가, 조건 청산 주문 확인, 캔들 수집이 모두 멈춥니다. 켜 둔 동안만 동작합니다.

**문제 해결**

| 증상 | 원인과 해결 |
| --- | --- |
| 시작 시 "전략 코어를 찾을 수 없습니다" 경고, 전략 데이터 오류 | strategy-core 실행파일을 server.js와 같은 폴더에 두거나 STRATEGY\_CORE 환경변수로 경로를 지정합니다. 리눅스·맥은 실행 권한도 필요합니다. |
| "데이터 로드 실패" 창 | 야후 접속 실패나 잘못된 티커입니다. 티커 철자와 인터넷 연결을 확인하고 새로고침합니다. |
| 알람 소리가 나지 않음 | 알람 소리 버튼이 켜져 있는지, 페이지를 한 번이라도 클릭했는지, 알림 종목이 현재 차트 종목인지, 지금이 매매 시간 안인지 확인합니다. 차트에 신호 마커가 아직 안 보이면 대기 중인 상태입니다. |
| 신호가 바뀌었는데 알림이 없음 | 알림 적용 직후 첫 평가이거나, 매매 시간 밖이거나, 알림이 10분을 넘겨 폐기된 경우입니다. |
| "증거금이 부족합니다" | 주문 가능 금액이 부족합니다. 수량을 줄이거나 포지션을 청산하거나 계좌를 초기화합니다. |
| "신호가 해제되어 체결하지 않았습니다" | 전략 C의 조건이 알림 후 바뀌었습니다. 새 신호를 기다립니다. |
| 차트 신호와 성과 카드 숫자가 다름 | 신호 고정 때문입니다 (10장). 맞추려면 신호기록 초기화를 사용합니다. |
| 리플레이에 "저장된 캔들이 부족" | 해당 종목의 1분봉이 200개 미만입니다. 대시보드를 열어 두거나 REPLAY\_TICKERS에 종목을 지정해 데이터를 쌓습니다. |
| 모의 계좌 파일 로드 실패 | 파일이 깨진 경우입니다. 삭제하면 새 계좌로 시작합니다. 삭제 전에 백업해 두세요. |

저작자표시 (새창열림)

728x90

AI 시대의 마음가짐

AI 시대 마음가짐에 대한 답변을 준비 중.

AI 시대의 마음가짐에 대해 제가 중요하다고 생각하는 것들을 말씀드릴게요.

1. 도구로 쓰되, 판단은 내가 합니다. AI는 초안, 정리, 탐색에는 매우 빠르지만 틀린 내용을 자신 있게 말하기도 합니다. 결과물을 받아들이기 전에 "이게 맞나?"를 스스로 확인하는 습관이 가장 큰 차이를 만듭니다. 무엇을 만들지 정하고 결과에 책임지는 일은 여전히 사람의 몫입니다.

2. 질문하는 힘이 더 중요해집니다. 답을 찾는 비용은 크게 줄었으니, 어떤 문제를 풀 가치가 있는지, 무엇을 물어야 하는지가 실력이 됩니다. 문제를 잘 정의하는 사람이 AI도 잘 씁니다.

3. 배움을 맡기지 않습니다. 대신 해주는 편리함에 기대면 정작 내 실력은 자라지 않습니다. 직접 해보고, AI는 그 과정을 돕는 코치나 토론 상대로 쓰는 쪽이 오래 갑니다. 막혔을 때 정답을 바로 받기보다 힌트를 요청해 보세요.

4. 불안보다 호기심을 택합니다. "내 일이 사라질까"라는 걱정은 자연스럽지만, 걱정만으로는 달라지는 게 없습니다. 직접 써 보면서 무엇이 되고 안 되는지 감을 잡으면 막연한 불안이 구체적인 계획으로 바뀝니다. 한계를 아는 사람이 가장 잘 활용합니다.

5. 사람만이 줄 수 있는 것을 키웁니다. 신뢰, 공감, 책임감, 맥락 이해, 취향과 가치관처럼 관계와 경험에서 나오는 것들은 기술이 빨라질수록 오히려 더 귀해집니다.

6. 계속 바뀐다고 전제합니다. 지금의 도구와 방법은 곧 달라질 테니, 하나의 정답을 외우기보다 가볍게 실험하고 고쳐 가는 태도가 필요합니다.

어떤 맥락에서 궁금하신지 알려주시면 더 구체적으로 이야기할 수 있어요. 직장, 학습, 진로, 아이 교육, 발표나 글쓰기 소재 중 어디에 가까우신가요?

겸손해지자

맞아요, 겸손은 AI 시대에 특히 힘을 발휘하는 태도라고 생각해요. 방향이 두 가지로 나뉩니다.

AI 앞에서의 겸손. AI가 모르는 것, 틀리는 것이 분명히 있습니다. 그렇다고 AI를 무시하라는 게 아니라, 빠르고 유창한 답이 곧 맞는 답은 아니라는 걸 기억하자는 거예요. 반대로 “AI가 나보다 낫네” 하고 무작정 따르는 것도 겸손이 아니라 판단을 내려놓는 일입니다. 겸손은 확인하고, 의심하고, 틀렸을 때 고치는 태도에 가깝습니다.

나 자신 앞에서의 겸손. 내가 아는 것의 한계를 인정하면 배울 문이 열립니다. AI에게 "이 부분 내가 잘 모르는데 설명해 줘"라고 편하게 묻는 사람이 가장 빨리 늘어요. 아는 척하지 않아도 되는 상대가 생긴 셈이니까요.

성과 앞에서의 겸손. AI 덕분에 결과물이 좋아졌을 때 온전히 내 실력으로만 여기면 착시가 생깁니다. 도움받은 부분과 내가 한 부분을 구분해서 보면 앞으로 키워야 할 곳이 더 선명해져요.

한 줄로 줄이면, "나도 틀릴 수 있고 AI도 틀릴 수 있다"는 전제에서 함께 확인하며 가는 태도라고 할 수 있겠습니다.

이 주제로 글이나 발표를 준비 중이신가요? 아니면 스스로 다짐을 정리하시는 중인가요? 용도에 맞춰 더 다듬어 드릴 수 있어요.

저작자표시 (새창열림)

728x90

물타기의 무서움

현재 $56에 2주를 보유한 상태에서 $5 하락할 때마다 1주씩 추가 매수하면, 마지막 $21 매수 시점에 총 9주 보유, 총 투자금 $364, 최종 평균 단가는 $40.44가 됩니다.

구간별 물타기 시뮬레이션 결과와 SOXS(3배 인버스 레버리지 ETF) 분할 매수 시 반드시 유의해야 할 핵심 리스크를 정리했습니다.

구간별 매수 시뮬레이션

$56에서 시작해 $5 간격으로 $20 이상 구간($21까지 총 7회 추가 매수)을 채웠을 때의 변화입니다. (수수료 및 환전 비용 제외)

매수 회차매수 단가추가 수량누적 수량누적 투자금평균 단가본전 도달 필요 상승률

초기 보유	$56	2주	2주	$112	$56.00	0.0%
1차 물타기	$51	1주	3주	$163	$54.33	+6.5%
2차 물타기	$46	1주	4주	$209	$52.25	+13.6%
3차 물타기	$41	1주	5주	$250	$50.00	+22.0%
4차 물타기	$36	1주	6주	$286	$47.67	+32.4%
5차 물타기	$31	1주	7주	$317	$45.29	+46.1%
6차 물타기	$26	1주	8주	$343	$42.88	+64.9%
7차 물타기	$21	1주	9주	$364	$40.44	+92.6%

(참고: 만약 $20 도달 시점에 1주를 추가로 더 매수한다면 총 10주, 총 투자금 $384, 평균 단가 $38.40이 됩니다.)

저작자표시 (새창열림)

728x90

MiniMax H3 워크플로우

MiniMax H3를 ComfyUI에서 더 높은 화질로 활용하기 위해 다듬은 워크플로우를 소개합니다.
여러 조합을 테스트하며 선택한 Singularity와 8스텝 Turbo LoRA를 사용하고, 처음 7스텝에서 구도를 만든 뒤 마지막 1스텝에서 업스케일과 리파인을 진행합니다.

텍스트 인코더 언로드, VAE 디코딩 전 VRAM 확보, Sol Attenti

https://youtu.be/ymVhU6L-Nfc?si=i-sHe2XexMfyEZpA