일목균형표 복합지표 추가

일목균형표 전략.md

@@ -0,0 +1,397 @@
+# 일목균형표(Ichimoku Kinko Hyo) 전략 — 구성 요소·매매 로직·엘리어트 파동 연계
+
+goldenChart **투자전략 DSL**의 `ICHIMOKU` 지표 조건과 연동하여, 일목균형표의 시간·가격 균형 관계와 엘리어트 파동(Elliott Wave) 단계별 전략 조건을 정리한 문서입니다.
+
+> **관련 문서:** [매매전략조건.md](./매매전략조건.md) · [전략편집기 로직 및 동작흐름.md](./전략편집기%20로직%20및%20동작흐름.md)  
+> **내장 템플릿:** `ICHIMOKU_TREND` · `ICHIMOKU_SANYAKU`(삼역호전) · `ICHIMOKU_PERFECT`(5원소)
+
+---
+
+## 1. 일목균형표란
+
+일목균형표는 **과거·현재·미래**의 가격 균형을 한 차트(일목)에 담은 추세·지지·저항 통합 지표입니다.  
+단순 이동평균 교차가 아니라, **선행(구름)·후행(26봉 지연)** 개념으로 시장의 “시간적 균형”을 읽습니다.
+
+### 1.1 핵심 구성 요소
+
+| 구성 요소 | DSL 필드 | 계산 (표준 9·26·52) | 시장에서의 역할 |
+|-----------|----------|---------------------|-----------------|
+| **전환선** (Conversion Line) | `CONVERSION_LINE` | (9봉 최고+최저) ÷ 2 | 단기 균형점. 주가의 **단기 방향·속도** |
+| **기준선** (Base Line) | `BASE_LINE` | (26봉 최고+최저) ÷ 2 | 중기 균형점. **추세 그 자체**, 강한 지지·저항 |
+| **선행스팬 1** (Leading Span 1) | `LEADING_SPAN1` | (전환선+기준선) ÷ 2, **26봉 선행** | 단·중기 평균을 미래로 투영 → **구름 상·하단** |
+| **선행스팬 2** (Leading Span 2) | `LEADING_SPAN2` | (52봉 최고+최저) ÷ 2, **26봉 선행** | 장기 균형점 → **구름 두께**·매물대 강도 |
+| **구름대** (Kumo / Cloud) | `LEADING_SPAN1` ↔ `LEADING_SPAN2` | 선행1·2 사이 영역 | 지지(양운) / 저항(음운) **매물·심리 경계** |
+| **후행스팬** (Lagging Span) | `LAGGING_SPAN` | 현재 종가를 **26봉 후행** 표시 | 현재 vs 26봉 전 종가 비교 → **추세 확정** |
+
+### 1.2 구성 요소 간 관계 (개념도)
+
+```text
+                    [미래]  ← 선행스팬1·2 (26봉 앞)
+                         ╱╲  구름대 (Kumo)
+                        ╱  ╲
+    전환선 ────●────●────●────  (9봉, 가장 민감)
+    기준선 ────────●────●────  (26봉, 추세의 중심)
+    종가   ──────────●────────  (현재)
+    후행   ────────────────●──  (종가를 26봉 뒤에 표시)
+                    [과거]
+```
+
+| 관계 | 의미 | 해석 |
+|------|------|------|
+| 전환선 ↔ 기준선 | 단기 vs 중기 균형 | 교차 = **추세 전환 1차 신호** |
+| 선행1 vs 선행2 | 구름 색·두께 | 선행1>선행2 → **양운**(상승 구름), 반대 → **음운** |
+| 종가 vs 구름 | 현재가 위치 | 구름 위 = 강세, 아래 = 약세, 내부 = **전환·횡보** |
+| 후행 vs 26봉 전 종가 | 시간 지연 확인 | 후행이 과거 종가 위 = **상승 추세 확정** |
+
+### 1.3 호전(정배열) vs 역전(역배열)
+
+#### 🟩 호전 — 완벽한 상승 추세
+
+```text
+종가 > 전환선 > 기준선 > 구름(양운)
+후행스팬 > 26봉 전 종가
+(선택) 후행스팬 > 26봉 전 구름
+```
+
+| 확인 항목 | DSL 조건 예시 |
+|-----------|---------------|
+| 괘(가격선) | `CONVERSION_LINE GT BASE_LINE` |
+| 주가·구름 | `CLOSE_PRICE ABOVE_CLOUD` |
+| 구름 성격 | `SPAN1_GT_SPAN2` (양운) |
+| 후행 확정 | `LAGGING_GT_PRICE` |
+
+#### 🟥 역전 — 완벽한 하락 추세
+
+```text
+종가 < 전환선 < 기준선 < 구름(음운)
+후행스팬 < 26봉 전 종가
+```
+
+| 확인 항목 | DSL 조건 예시 |
+|-----------|---------------|
+| 괘 | `CONVERSION_LINE LT BASE_LINE` |
+| 주가·구름 | `CLOSE_PRICE BELOW_CLOUD` |
+| 구름 성격 | `SPAN1_LT_SPAN2` (음운) |
+| 후행 확정 | `LAGGING_LT_PRICE` |
+
+---
+
+## 2. 상황별 기본 매수·매도 판단 로직
+
+### 2.1 매수(Long) 타이밍
+
+| # | 상황 | 판단 근거 | DSL 조건 (예) | 강도 |
+|---|------|-----------|---------------|------|
+| L1 | **골든크로스(호전)** | 전환선이 기준선 상향 돌파 | `CONVERSION_LINE CROSS_UP BASE_LINE` | ★★★ |
+| L2 | **기준선 돌파** | 중기 추세 전환 | `CLOSE_PRICE CROSS_UP BASE_LINE` | ★★★ |
+| L3 | **구름 돌파** | 매물대·심리 저항 돌파 | `CLOUD_BREAK_UP` | ★★★★ |
+| L4 | **후행 호전** | 26봉 전 대비 추세 확정 | `LAGGING_GT_PRICE` (또는 `CROSS_UP`) | ★★★★ |
+| L5 | **구름 지지** | 양운 상단·기준선에서 반등 | `CLOSE_PRICE GT LEADING_SPAN1` + `GT BASE_LINE` | ★★ |
+| L6 | **삼역호전** | ①괘 ②구름 ③후행 동시 | 아래 §3.3 참조 | ★★★★★ |
+
+**매수 시 주의**
+
+- 구름 **내부**(`IN_CLOUD`)에서는 신호 빈도↑·신뢰도↓ → 필터(거래량·ADX) 권장.
+- `CROSS_*` 조건은 **해당 봉 1회**만 true → 연속 보유는 `GT`/`ABOVE_CLOUD` 등 **상태 조건** 병행.
+
+### 2.2 매도(Short / 청산) 타이밍
+
+| # | 상황 | 판단 근거 | DSL 조건 (예) | 강도 |
+|---|------|-----------|---------------|------|
+| S1 | **데드크로스(역전)** | 전환선 기준선 하향 이탈 | `CONVERSION_LINE CROSS_DOWN BASE_LINE` | ★★★ |
+| S2 | **기준선 이탈** | 중기 추세 붕괴 | `CLOSE_PRICE CROSS_DOWN BASE_LINE` | ★★★ |
+| S3 | **구름 이탈** | 지지 붕괴 | `CLOUD_BREAK_DOWN` | ★★★★ |
+| S4 | **후행 역전** | 하락 추세 확정 | `LAGGING_LT_PRICE` | ★★★★ |
+| S5 | **구름 저항** | 음운 하단·기준선에서 반락 | `CLOSE_PRICE LT LEADING_SPAN1` + `LT BASE_LINE` | ★★ |
+| S6 | **삼역역전** | ①데드 ②구름하 ③후행하 | §3.3 역방향 | ★★★★★ |
+
+**매도(청산) 설계 팁**
+
+- 추세 추종: `OR(데드크로스, 종가<전환선, 구름하향돌파)` — **연속 매도 방지**.
+- 익절: 5파·과열 구간에서는 전환선 이탈만으로도 1차 청산 신호로 사용.
+
+### 2.3 구름·선행스팬 해석 요약
+
+| 구름 상태 | 선행1 vs 선행2 | 종가 위치 | 일반적 해석 |
+|-----------|----------------|-----------|-------------|
+| **양운** | 선행1 > 선행2 | 종가 > 구름 | 상승 추세, 구름 = **지지** |
+| **음운** | 선행1 < 선행2 | 종가 < 구름 | 하락 추세, 구름 = **저항** |
+| **얇은 구름** | 두 선행 간격 좁음 | 돌파 직후 | 변곡·추세 전환 **임박** |
+| **두꺼운 구름** | 두 선행 간격 넓음 | 구름 안·근처 | **강한 매물대**, 돌파 난이도↑ |
+
+---
+
+## 3. 삼역호전 / 삼역역전 — 핵심 복합 신호
+
+### 3.1 삼역호전 (三役好轉) — 강력 매수
+
+| 역(役) | 일목 요소 | 조건 |
+|--------|-----------|------|
+| **괘** | 전환·기준 | 전환선 > 기준선 (또는 골든크로스) |
+| **주가** | 종가·구름 | 종가 > 구름 (`ABOVE_CLOUD` / `CLOUD_BREAK_UP`) |
+| **후행** | 후행·과거 종가 | 후행 > 26봉 전 종가 (`LAGGING_GT_PRICE`) |
+
+**goldenChart 템플릿:** `ICHIMOKU_SANYAKU` — 구름 돌파(현재 봉) + 단계별 필터(N봉 EXISTS_IN).
+
+### 3.2 삼역역전 — 강력 매도·대피
+
+| 역 | 조건 |
+|----|------|
+| 괘 | 전환선 < 기준선 (데드크로스) |
+| 주가 | 종가 < 구름 (`BELOW_CLOUD` / `CLOUD_BREAK_DOWN`) |
+| 후행 | 후행 < 26봉 전 종가 (`LAGGING_LT_PRICE`) |
+
+### 3.3 5원소 입체 매매 (Perfect Ichimoku)
+
+괘 · 주가 · 구름(양/음운) · 후행 **4중 AND** — ta4j `PerfectIchimokuStrategy` 동형.
+
+**goldenChart 템플릿:** `ICHIMOKU_PERFECT` (필터 강도에 따라 2~4조건).
+
+---
+
+## 4. 엘리어트 파동 × 일목균형표 — 단계별 전략 조건
+
+엘리어트 파동의 **추세 전개**와 일목의 **선행·후행 시간 구조**를 결합하면, 파동 단계별 진입·청산 근거를 명확히 할 수 있습니다.
+
+> **전제:** 아래 “파동”은 **추정**이며, 실전에서는 상위·하위 시간대 일목을 함께 봅니다.  
+> 조건은 goldenChart DSL로 표현 가능한 형태로 기술합니다.
+
+---
+
+### 4.1 1파 — 상승 시동 (추세 전환 시작)
+
+| 항목 | 내용 |
+|------|------|
+| **파동 특징** | 장기 하락 종료 후 첫 반등. 바닥 예측 난이도 **최고** |
+| **일목 상태** | 하락하던 전환·기준선을 **순차 돌파** 시작. 위에는 **두터운 음운**이 여전히 존재 |
+| **관계** | 종가 ≈ 전환선 근처, 기준선 **미돌파 또는 돌파 직후**, 구름 **아래·내부** |
+
+**전략 조건**
+
+| 구분 | 조건 | DSL 예시 |
+|------|------|----------|
+| 공격적 매수 | 기준선 상향 돌파 | `CLOSE_PRICE CROSS_UP BASE_LINE` |
+| 보조 확인 | 전환 > 기준 | `CONVERSION_LINE GT BASE_LINE` |
+| 필터(권장) | 아직 구름 아래면 **소액·분할** | `NOT ABOVE_CLOUD` → 포지션 축소 |
+| 매도/관망 | 음운 하단 저항 | `CLOSE_PRICE LT LEADING_SPAN2` 유지 시 추가 매수 자제 |
+
+**판단:** 삼역호전 **미충족** → `ICHIMOKU_TREND`(골든크로스) 수준만 허용, `SANYAKU`/`PERFECT`는 **대기**.
+
+---
+
+### 4.2 2파 — 첫 번째 조정 (눌림목)
+
+| 항목 | 내용 |
+|------|------|
+| **파동 특징** | 1파 되돌림(종종 50~61.8%). **마지막 저가 테스트** |
+| **일목 상태** | 주가 재하락하나 **선행2(구름 하단)·과거 바닥** 미이탈. 전환·기준 **수평 방어** |
+| **관계** | 종가 > 기준선 또는 구름 하단(선행2) **지지** |
+
+**전략 조건**
+
+| 구분 | 조건 | DSL 예시 |
+|------|------|----------|
+| **1차 적극 매수** | 기준선·구름 하단 지지 후 반등 | `CLOSE_PRICE GT BASE_LINE` AND `CLOSE_PRICE GT LEADING_SPAN2` |
+| 확인 | 전환 > 기준 유지 | `CONVERSION_LINE GT BASE_LINE` |
+| 손절 | 기준선·선행2 동시 이탈 | `CLOSE_PRICE CROSS_DOWN BASE_LINE` OR `CLOUD_BREAK_DOWN` |
+| 금지 | 후행 아직 미호전 | `LAGGING_LT_PRICE` 지속 시 **풀매수 금지** |
+
+**판단:** **2파 끝 = 기준선/양운 상단 지지** → 3파 전 **핵심 분할 매수 구간**.
+
+---
+
+### 4.3 3파 — 본격 상승 (핵심 수익 구간)
+
+| 항목 | 내용 |
+|------|------|
+| **파동 특징** | 거래량·길이 **최대**. 추세 추종 수익 **극대화** 구간 |
+| **일목 상태** | **삼역호전 완성**. 얇은 구름 돌파 → 앞선 **두터운 양운** |
+| **관계** | 종가 > 전환 > 기준 > 구름, 후행 > 26봉 전 종가·구름 |
+
+**전략 조건 (삼역호전 = 3파 확인)**
+
+```text
+AND(
+  CONVERSION_LINE GT BASE_LINE,      /* 괘 */
+  CLOSE_PRICE ABOVE_CLOUD,           /* 주가 — 또는 CLOUD_BREAK_UP */
+  LAGGING_GT_PRICE,                  /* 후행 */
+  SPAN1_GT_SPAN2                     /* 양운 (선택) */
+)
+```
+
+| 구분 | 전략 |
+|------|------|
+| **매수** | 삼역호전 충족 시 **추가 매수·불타기** (`ICHIMOKU_SANYAKU` / `PERFECT`) |
+| **보유** | 종가 > **전환선** 유지 → **매도 금지** (추세 타기) |
+| **청산 경고** | 전환선 이탈 **전**까지 보유 극대화 |
+| **손절** | `CLOUD_BREAK_DOWN` 또는 `CONVERSION_LINE CROSS_DOWN BASE_LINE` |
+
+**판단:** �lliott **3파 ≈ 일목 삼역호전** — 시스템상 **가장 신뢰도 높은 롱 구간**.
+
+---
+
+### 4.4 4파 — 조정 (복잡한 횡보)
+
+| 항목 | 내용 |
+|------|------|
+| **파동 특징** | 삼각형·횡보. 변동성↑, 방향성 혼란 |
+| **일목 상태** | 급등 후 **기준선 지지 테스트**. 일시 **구름 내부** 진입 가능 |
+| **관계** | 종가 ≈ 기준선 · 선행1(구름 상단). 전환·기준 **수렴** |
+
+**전략 조건**
+
+| 구분 | 조건 | DSL 예시 |
+|------|------|----------|
+| 일부 익절 | 기준선 이탈 | `CLOSE_PRICE CROSS_DOWN BASE_LINE` |
+| 재매수 | 구름 **상단(선행1)** 지지 | `CLOSE_PRICE GT LEADING_SPAN1` AND `IN_CLOUD` 또는 `ABOVE_CLOUD` 회복 |
+| 관망 | 구름 내부 장기 체류 | `IN_CLOUD` + `HOLD_N_DAYS` → 방향 재확인 전 **신규 진입 자제** |
+| 손절 | 구름 하단 이탈 | `CLOUD_BREAK_DOWN` |
+
+**판단:** **단기 매매** 구간. 추세 추종은 포지션 **축소**, 스윙만 선행1·기준선 지지에서 재진입.
+
+---
+
+### 4.5 5파 — 마지막 상승 (과열·분산 매도)
+
+| 항목 | 내용 |
+|------|------|
+| **파동 특징** | 신고가 갱신 but **모멘텀 둔화**. 대중 **후행 참여** |
+| **일목 상태** | 종가·전환·기준 **이격 과대**. 후행은 위에 있으나 **꺾임** 조짐. 구름 **얇아짐** |
+| **관계** | `DIFF_GT(종가, 전환선)` 과열 · `SPAN1`/`SPAN2` 간격 축소 |
+
+**전략 조건**
+
+| 구분 | 조건 | 전략 |
+|------|------|------|
+| 분할 매도 | 신고가 + 전환선과 이격 확대 | `CLOSE_PRICE GT CONVERSION_LINE` + `DIFF_GT` (임계값) |
+| 1차 청산 | **전환선 이탈** | `CLOSE_PRICE CROSS_DOWN CONVERSION_LINE` |
+| 2차 청산 | 데드크로스 | `CONVERSION_LINE CROSS_DOWN BASE_LINE` |
+| 전량 익절 | 구름 재진입·하향 | `CLOUD_BREAK_DOWN` 또는 `BELOW_CLOUD` |
+
+**판단:** **매수 금지** · 보유분 **점진적 분할 매도**. 3파와 달리 **전환선 = 생명선**.
+
+---
+
+### 4.6 A-B-C 조정파 — 하락 전환
+
+#### A파 (하락 개시)
+
+| 일목 | 조건 |
+|------|------|
+| 기준선 **강한 이탈** | `CLOSE_PRICE CROSS_DOWN BASE_LINE` |
+| 데드크로스 | `CONVERSION_LINE CROSS_DOWN BASE_LINE` |
+| 전략 | **신규 매수 중단**, 5파 잔량 **청산 가속** |
+
+#### B파 (기술적 반등)
+
+| 일목 | 조건 |
+|------|------|
+| 반등하나 **기준선·음운 하단** 저항 | `CLOSE_PRICE CROSS_UP BASE_LINE` 후 `LT BASE_LINE` 재이탈 |
+| 구름 | `BELOW_CLOUD` 유지, `CLOUD_BREAK_UP` **실패** |
+| 전략 | 기준선 터치 후 **전량 매도·대피** (가짜 반등) |
+
+**DSL 예시 (B파 저항 확인):**
+
+```text
+AND(
+  CLOSE_PRICE LT BASE_LINE,
+  BELOW_CLOUD,
+  CONVERSION_LINE LT BASE_LINE
+)
+```
+
+#### C파 (본 하락)
+
+| 일목 | 조건 |
+|------|------|
+| 구름 완전 이탈 | `CLOUD_BREAK_DOWN` + `BELOW_CLOUD` |
+| 삼역역전 | 데드 + 구름 아래 + `LAGGING_LT_PRICE` |
+| 전략 | **물타기 금지**, 현금·인버스. `ICHIMOKU_SANYAKU` 매도 OR 조건 활용 |
+
+---
+
+## 5. 파동 × 일목 — 한눈에 보는 매매 매트릭스
+
+| 파동 | 일목 핵심 상태 | 매수 | 매도/청산 | goldenChart 템플릿 참고 |
+|------|----------------|------|-----------|-------------------------|
+| **1파** | 기준선 돌파 시도, 음운 위 | 소액·분할 | 관망 | `ICHIMOKU_TREND` (relaxed) |
+| **2파** | 기준선·선행2 지지 | **적극 1차 매수** | 지지 이탈 시 손절 | `TREND` + 구름 하단 `GT` |
+| **3파** | **삼역호전** | **추가·불타기** | 전환선 이탈 전 보유 | `ICHIMOKU_SANYAKU` / `PERFECT` |
+| **4파** | 기준선·구름 상단 횡보 | 지지 확인 시만 | 기준선 이탈 익절 | `IN_CLOUD` 필터 |
+| **5파** | 이격 과열, 얇은 구름 | **금지** | 전환선·데드 **분할 매도** | `CROSS_DOWN` 전환선 |
+| **A파** | 기준선 붕괴 | 금지 | 잔량 청산 | `TREND` sell |
+| **B파** | 기준선·음운 저항 | 금지 | **전량 매도** | `BELOW_CLOUD` + `LT BASE` |
+| **C파** | 삼역역전 | 금지 | 대피·숏 | `ICHIMOKU_SIT_EW_C_SELL` |
+
+> **복합지표 팔레트:** `ICHIMOKU_SIT_*` — 기본(L1~S6)·호전·역전·엘리어트(1~5·A~C) 파동별 매수/매도 조건 세트 (전략편집기 복합지표 탭)
+
+---
+
+## 6. goldenChart 전략편집기 적용 가이드
+
+### 6.1 내장 템플릿 매핑
+
+| 템플릿 | 적합 파동 | 핵심 조건 |
+|--------|-----------|-----------|
+| `ICHIMOKU_TREND` | 1파·2파·A파 | 전환↔기준 골든/데드 + (선택) 구름 |
+| `ICHIMOKU_SANYAKU` | **3파** | 구름 돌파 + 후행·전환 필터 |
+| `ICHIMOKU_PERFECT` | 3파 (strict) | 4중 AND — 신호↓ 품질↑ |
+| `ICHIMOKU_BB` | 4파·5파 | 후행 vs 볼린저 — 변동성·과열 |
+
+### 6.2 필터 강도 권장 (파동별)
+
+| 파동 | `relaxed` | `balanced` | `strict` |
+|------|-----------|------------|----------|
+| 1~2파 | ○ 진입 탐색 | △ | ✕ (과도) |
+| **3파** | △ | **○** | ○ (확신 시) |
+| 4~5파 | — (매수 X) | 청산 보조 | 익절 강화 |
+| A~C파 | — | 매도 | **삼역역전** |
+
+### 6.3 조건 설계 시 유의사항
+
+1. **`CROSS_*` vs `GT/LT`:** 돌파 **트리거**는 CROSS, **보유**는 GT/ABOVE_CLOUD.
+2. **EXISTS_IN 윈도우:** 삼역호전 보조 필터에만 사용 — 트리거에 쓰면 시그널 과다.
+3. **멀티 타임프레임:** 3파 확인 = 상위 TF `ABOVE_CLOUD` + 하위 TF `CROSS_UP` 조합 권장.
+4. **엘리어트 병행:** 파동 카운트는 주관적 → 일목 **상태 조건**으로 객관화.
+
+---
+
+## 7. 요약 — 판단 흐름도
+
+```text
+[하락/바닥] 1파: 기준선 돌파? ──No──→ 관망
+                │
+               Yes (소액)
+                ↓
+            2파: 기준선·선행2 지지? ──No──→ 손절
+                │
+               Yes (1차 매수)
+                ↓
+            3파: 삼역호전? ──No──→ 대기/추가 관망
+                │
+               Yes (적극 매수·보유)
+                ↓
+            4파: 기준선·구름상단 지지? → 재매수 or 일부익절
+                ↓
+            5파: 전환선 이탈? → 분할 매도
+                ↓
+            A-B-C: 기준선 저항·삼역역전? → 전량 청산·대피
+```
+
+---
+
+## 8. 참고 — 표준 기간 (9 · 26 · 52)
+
+| 요소 | 기간 | 시간축 의미 |
+|------|------|-------------|
+| 전환선 | 9 | 단기 (약 1.5주, 일봉 기준) |
+| 기준선 | 26 | 중기 (약 1달) |
+| 선행스팬 | 26 선행 | **1달 앞** 매물·심리 |
+| 선행2 | 52 | 장기 (약 2.5달) |
+| 후행 | 26 후행 | **1달 전**과 현재 비교 |
+
+분봉(3m·15m) 사용 시 동일 비율을 유지하되, `ICHIMOKU_SANYAKU` 템플릿의 EXISTS_IN 윈도우(N봉)를 **타임프레임에 맞게** 조절합니다.
+
+---
+
+*문서 버전: 2026-03 · goldenChart 전략 DSL `ICHIMOKU` 조건셋 기준*