Consolidation and Breakout Detector

Consolidation and Breakout Detector는 통합 구역(횡보 시장)을 식별하고 돌파 기회를 감지하고자 하는 트레이더를 위해 설계된 고급 단일 시간 프레임 MT5 지표입니다.
이 지표는 과거 가격 움직임을 자동으로 스캔하여 시장이 횡보하는 영역을 식별하고, 유효한 돌파가 발생하면 트레이더에게 알림을 제공합니다.

이 도구는 돌파 트레이더, 추세 추종자 및 횡보 시장 트레이더에게 유용하며, 가격 구조에 기반한 보다 정확한 거래 결정을 내릴 수 있도록 도와줍니다.

🏆 주요 기능
✅ 가격 움직임을 기반으로 통합 구역을 감지
✅ 맞춤형 라벨 및 화살표로 돌파 지점을 강조
✅ 다양한 돌파 확인 모드 제공 (종가 기준 & 고점/저점 기준)
✅ 사용자가 설정한 색상으로 통합 영역을 시각적으로 표시
✅ 과거 통합 구역을 확장하여 더욱 명확한 분석 가능 (백워드 익스텐션 기능)
✅ 모든 거래 전략에 맞게 완벽한 사용자 설정 지원
✅ 모든 시간 프레임 및 자산(외환, 주식, 암호화폐, 지수 등)에서 작동
✅ 최소한의 지연으로 실시간 시장 분석 제공

📊 작동 방식
이 지표는 통합 및 돌파 구역을 감지하기 위한 체계적인 절차를 따릅니다.

🔍 통합 구역 감지

• X개의 과거 캔들(사용자 설정값 기준)을 스캔하여 고점과 저점을 식별
• 시장이 Y개의 캔들 동안 좁은 범위 내에서 움직이면 통합 구역이 형성됨
• 이 범위는 차트에서 빨간색 상자(사용자 설정 가능)로 표시됨

⚡ 돌파 확인

• 구역이 감지된 후, 지표는 돌파를 기다림
• 가격이 설정된 캔들 수 이상으로 구역을 벗어나면 돌파가 확인됨
• 돌파는 다음 기준을 기반으로 감지 가능:
  • 종가 기준(보수적인 방법)
  • 고점/저점 기준(공격적인 방법)

👀 시각적 알림

• 상방 돌파 발생 시, 초록색 라벨 & 화살표 표시
• 하방 돌파 발생 시, 빨간색 라벨 & 화살표 표시
• 라벨과 화살표의 크기, 색상, 글꼴, 위치는 모두 사용자 설정 가능

⚙ 입력 매개변수 & 사용자 설정
이 지표는 통합 구역과 돌파 구역을 사용자 정의할 수 있도록 다양한 입력 옵션을 제공합니다.

🔎 통합 설정

• prd (조회 기간) – 고점/저점을 분석할 과거 캔들 수
• conslen (최소 통합 길이) – 유효한 통합 구역으로 인식되기 위한 최소 캔들 수

예시:

• prd = 100 , conslen = 50 이면, 지표는 최근 100개의 캔들을 분석하고, 최소 50개의 캔들 동안 횡보하는 경우 통합 구역을 형성함

💥 돌파 설정

• breakoutCandles (돌파 확인 캔들 수) – 구역 외부에서 연속 발생해야 하는 캔들 수
• breakoutMode (돌파 확인 방식)
  • BREAKOUT_CLOSE : 종가가 구역을 벗어나야 돌파로 확인
  • BREAKOUT_HIGH_LOW : 고점/저점이 구역을 벗어나야 돌파로 확인

예시:

• breakoutCandles = 2 이면, 가격이 구역을 벗어난 상태에서 최소 2개 이상의 캔들이 형성되어야 돌파가 확정됨

🎨 시각화 설정

• paintcons – 통합 구역을 차트에 표시 여부 설정
• zonecol – 통합 상자의 색상(기본값: 빨간색)
• boxBorderWidth – 통합 구역의 테두리 두께
• enableBackwardExtension – 과거 가격 데이터를 반영하여 통합 구역을 확장

예시:

• enableBackwardExtension = true 이면, 과거 가격 움직임을 분석하여 통합 구역의 왼쪽 경계를 자동으로 조정

🔡 글꼴 & 라벨 설정

• SelectedFont – 돌파 라벨에 사용할 글꼴 선택(예: Arial, Comic Sans MS 등)
• LabelFontSize – 라벨 글꼴 크기 조정
• LabelOffset – 라벨/화살표의 수직 위치 조정

예시:

• LabelOffset = 3 이면, 돌파 라벨이 해당 캔들 위 3핍(pip) 떨어진 곳에 표시됨

📌 돌파 라벨 & 화살표

• UpBreakLabel – 상방 돌파 시 표시되는 라벨 텍스트(기본값: "Break Up")
• DownBreakLabel – 하방 돌파 시 표시되는 라벨 텍스트(기본값: "Break Down")
• UpLabelColor / DownLabelColor – 돌파 라벨의 색상 설정
• UpArrowColor / DownArrowColor – 돌파 화살표의 색상 설정

예시:

• UpBreakLabel = "Bullish Breakout" 이면, 지표가 상방 돌파 발생 시 "Bullish Breakout" 라벨을 표시함

📝 로그 기록 & 디버깅

• enablePrintLogs – MT5 터미널에서 로그 출력 활성화 여부 설정

예시:

• enablePrintLogs = true 이면, 터미널에서 다음과 같은 메시지가 표시됨:
  • "새로운 통합 구역이 12:00에 감지됨"
  • "구역이 돌파됨 - 상방 돌파 14:30에 발생"