╔══════════════════════════════════════════════════════════════╗

║ AI US500 PRO ║

║ 하이브리드 트렌드 / 평균회귀 cBot ║

║ 멀티 AI • 멀티 타임프레임 ║

╚══════════════════════════════════════════════════════════════╝

🧠 **AI US500 PRO**는 S&P 500 지수(US500)를 위해 특별히 설계된 cTrader용 전문 cBot입니다. 다중 타임프레임 기술 분석과 인공지능을 결합하여 실행 전에 모든 거래를 필터링합니다.

이 봇은 **3개의 동시 타임프레임**(H4 → H1 → M15)에서 작동하며, 시장 상태(추세 또는 횡보)를 자동으로 감지하고 가장 적합한 전략을 적용합니다: 시장에 방향성이 있을 때는 추세 추종, 횡보할 때는 평균회귀 전략을 사용합니다. 생성된 모든 신호는 **13개의 지원 제공자** 중 선택한 AI 모델에 의해 실시간으로 검증될 수 있습니다.

`AccessRights.None`으로 실행 — 특별한 권한이 필요 없으며, cTrader의 기본 HTTP API를 사용합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📐 **전략 구조**

봇은 다음과 같은 단계별 의사결정 흐름을 따릅니다:

```

H4 (EMA 200) → 장기 방향성 편향 결정 (강세 / 약세 / 중립)

↓

H1 (EMA 50 + RSI 14) → 방향 확인 및 과도 확장 평가

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → 진입 신호 생성

↓

AI (Claude / GPT / Gemini / ...) → 신호를 신뢰도 점수로 필터링

↓

실행 → 거래량 계산, 동적 SL/TP, 트레일링 스톱

```

⚡ **시장 상태 감지 (ADX)**

— ADX ≥ 임계값 → 추세 시장 → 추세 추종 전략

— ADX < 임계값 → 횡보 시장 → 평균회귀 전략

이 전환은 완전히 자동으로, 바 단위로 이루어집니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 **추세 추종 전략**

롱 진입 조건:

✅ H4: 가격이 EMA 200 위에 있음 (강세 편향)

✅ H1: 가격이 EMA 50 위에 있고 RSI > 50

✅ M15: EMA 21이 EMA 50 위로 교차 (강세 교차)

✅ M15: 스토캐스틱 K가 D 위로 교차, K < 65 (과매수 아님)

숏 진입 조건: 반대 및 반전.

📊 **평균회귀 전략**

롱 진입 조건:

✅ ADX가 임계값 이하 (횡보 시장)

✅ M15: 가격이 하단 볼린저 밴드를 터치하거나 돌파

✅ M15: 스토캐스틱 K < 20 (과매도)

✅ H1: RSI < 35 (약세 과도 확장)

숏 진입 조건: 반대 및 반전.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **AI 통합 — 13개 제공자**

봇이 유효한 기술 신호를 생성하면, 실행 전에 AI에 다음과 같은 완전한 데이터 패킷을 전송합니다:

— 모든 다중 타임프레임 지표

— 최근 N개의 M15 캔들 (OHLCV)

— 제안된 방향 및 활성 전략

— 위험 매개변수 (SL/TP 핍 단위, R:R 비율)

— 계정 상태 및 열린 포지션

AI는 다음과 같이 응답합니다:

— **신뢰 점수** (0-100%)

— **결정** (GO / NO_GO)

— **주요 요인** (2-3개의 주요 요인)

— **위험 경고** (주요 식별된 위험)

신뢰도가 최소 임계값 아래로 떨어지면, 거래는 **차단**됩니다.

각 거래가 종료된 후, AI는 평가, 등급 및 교훈이 포함된 **거래 후 분석**도 제공합니다.

**지원 제공자:**

```

1. Anthropic (Claude) — claude-sonnet-4

2. OpenAI (ChatGPT) — gpt-4o

3. Google (Gemini) — gemini-2.0-flash

4. Mistral — mistral-large-latest

5. Groq — llama-3.3-70b-versatile

6. Perplexity — sonar-pro

7. Cohere — command-r-plus

8. xAI (Grok) — grok-2

9. DeepSeek — deepseek-chat

10. Together AI — Llama-3.3-70B-Instruct-Turbo

11. Fireworks AI — llama-v3p3-70b-instruct

12. OpenRouter — anthropic/claude-sonnet-4

13. Ollama (local, free) — llama3.1

```

각 제공자는 사전 구성된 기본 URL과 모델을 가지고 있습니다. 최대한의 유연성을 위해 모델과 URL 모두를 재정의할 수 있습니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 **매개변수 — 완전 가이드**

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💰 **1. 위험 관리**

▸ **위험 모드** — `PercentRisk` / `FixedLot`

백분율 기반 포지션 크기 조정 또는 고정 로트 중 선택합니다. PercentRisk 모드에서는 봇이 자동으로 손절 거리와 사용 가능한 자본을 기반으로 거래량을 계산합니다. 기본값: `PercentRisk`

▸ **거래당 위험 %** — 0.1% ~ 5.0%

각 거래에서 위험에 노출되는 계좌 잔액의 백분율입니다. SL이 발동되면 손실이 정확히 이 비율이 되도록 거래량이 계산됩니다. 기본값: `1.0%`

▸ **고정 거래량 (로트)** — 0.01 이상

고정 로트 단위 거래량이며, 위험 모드가 FixedLot일 때만 사용됩니다. 기본값: `0.1`

▸ **최대 오픈 포지션 수** — 1 ~ 10

봇이 동시에 보유할 수 있는 최대 포지션 수입니다. 한도에 도달하면 새로운 거래가 열리지 않습니다. 기본값: `3`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📈 **2. H4 추세 편향**

▸ **H4 EMA 기간** — 50 이상

H4 타임프레임에 적용되는 EMA 기간입니다. 장기 방향성 편향을 결정합니다. 가격이 EMA 위면 강세, 아래면 약세입니다. ATR 기반 버퍼가 가격이 평균에 너무 가까울 때 잘못된 신호를 방지합니다. 기본값: `200`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔍 **3. H1 확인**

▸ **H1 EMA 기간** — 10 이상

H1 타임프레임의 EMA 기간입니다. 진입 확인을 위해 가격이 이 EMA의 올바른 쪽에 있어야 합니다. 기본값: `50`

▸ **H1 RSI 기간** — 5 이상

H1의 상대강도지수 기간입니다. 추세 확인(RSI > 50은 롱, < 50은 숏)과 평균회귀에서 과도 확장 필터링(RSI < 35 또는 > 65)에 모두 사용됩니다. 기본값: `14`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 **4. M15 진입**

▸ **빠른 EMA 기간** — 5 이상

진입 타임프레임(M15)의 빠른 EMA입니다. 느린 EMA와의 교차가 추세 추종 신호를 생성합니다. 기본값: `21`

▸ **느린 EMA 기간** — 10 이상

느린 EMA입니다. 빠른/느린 EMA 교차가 추세 전략의 주요 트리거입니다. 기본값: `50`

▸ **스토캐스틱 K / D / 감속** — 스토캐스틱 오실레이터 기간

모멘텀 확인에 사용됩니다. 추세 전략에서는 극단적이지 않은 구역에서 진입을 필터링하며, 평균회귀에서는 과매수/과매도 영역을 식별합니다. 기본값: `K=14, D=3, Slowing=3`

▸ **볼린저 기간** — 10 이상

볼린저 밴드 기간입니다. 평균회귀에서 상단/하단 밴드 터치가 진입 트리거입니다. 기본값: `20`

▸ **볼린저 표준편차** — 1.0 이상

밴드 표준편차입니다. 값이 높을수록 밴드가 넓어져 신호는 적지만 더 신뢰할 수 있습니다. 기본값: `2.0`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌡️ **5. 시장 상태 감지 (ADX)**

▸ **ADX 기간** — 7 이상

방향성 이동 시스템 기간입니다. 방향과 무관하게 추세 강도를 측정합니다. 기본값: `14`

▸ **ADX 추세 임계값** — 15 ~ 40

추세 시장과 횡보 시장을 구분하는 임계값입니다. ADX가 이 값 이상이면 추세 추종 활성, 미만이면 평균회귀 활성입니다. 기본값: `25`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛡️ **6. SL / TP (ATR 기반)**

모든 손절매와 이익실현은 현재 ATR의 배수로 동적으로 계산됩니다. 이는 변동성에 자동으로 적응함을 의미합니다: 변동성이 낮은 시장에서는 타이트한 스톱, 변동성이 높은 시장에서는 더 넓은 스톱을 사용합니다.

▸ **ATR 기간** — 5 이상

평균 진폭 범위 기간입니다. 최근 변동성을 측정하며 SL, TP, 손익분기점 및 트레일링 계산의 기준이 됩니다. 기본값: `14`

▸ **SL x ATR** — 0.5 이상

손절매를 위한 ATR 배수입니다. 예: ATR이 20포인트이고 배수가 1.5이면, SL은 진입가에서 30포인트 떨어진 위치입니다. 기본값: `1.5`

▸ **TP x ATR (추세)** — 1.0 이상

추세 추종에서 이익실현을 위한 ATR 배수입니다. 일반적으로 SL보다 높아 유리한 R:R 비율을 만듭니다. 기본값: `2.5`

▸ **TP x ATR (회귀)** — 0.5 이상

평균회귀에서 이익실현을 위한 ATR 배수입니다. 목표가 평균으로의 회귀이므로 일반적으로 더 보수적입니다. 기본값: `1.5`

▸ **최소 SL (핍)** — 1 이상

최소 손절매 핍 수입니다. ATR 계산 결과가 이 값보다 낮으면 최소값이 대신 사용됩니다. 매우 낮은 변동성 조건에서 너무 타이트한 스톱을 방지합니다. 기본값: `10`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 **7. 트레일링 스톱**

자동 손익분기점 이동과 ATR 기반 트레일링 스톱을 포함한 오픈 포지션의 능동적 관리 시스템입니다.

▸ **트레일링 활성화** — 켜기/끄기

전체 트레일링 시스템을 활성화하거나 비활성화합니다. 꺼져 있으면 포지션은 종료 시까지 고정 SL/TP를 유지합니다. 기본값: `켜기`

▸ **손익분기점 이동 기준 x ATR** — 0.3 이상

미실현 이익이 이 ATR 배수에 도달하면 SL이 진입가(+ 비용 커버를 위한 스프레드 절반)로 이동합니다. 거래가 무위험 상태가 됩니다. 기본값: `1.0`

▸ **트레일 거리 x ATR** — 0.5 이상

현재 가격으로부터의 트레일링 스톱 거리이며 ATR 배수로 표현됩니다. SL은 가격을 따라가며 절대 뒤로 움직이지 않습니다. 기본값: `1.2`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🕐 **8. 세션 필터**

시간을 기준으로 거래 활동을 필터링합니다. US500은 프리마켓, 정규 세션, 애프터아워에서 매우 다르게 움직입니다.

▸ **세션 필터 활성화** — 켜기/끄기

시간 필터를 활성화하거나 비활성화합니다. 기본값: `켜기`

▸ **세션 시작 (CET 시간 기준 시)** — 0-23

거래 창 시작 시간 (CET 타임존). 기본값: `15` (미국 세션 시작)

▸ **세션 종료 (CET 시간 기준 시)** — 0-23

거래 창 종료 시간. 기본값: `22` (미국 세션 종료)

봇은 자정 넘는 세션도 지원합니다 (예: 시작=22, 종료=6).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ **9. 기타**

▸ **쿨다운 (바 수)** — 0 이상

한 거래와 다음 거래 사이에 지나야 하는 최소 M15 바 수입니다. 빠른 신호 상황에서 과도한 거래를 방지합니다. 기본값: `3` (= 45분)

▸ **대시보드 표시** — 켜기/끄기

차트 위 대시보드 표시/숨기기 (시장 상태, 편향, 지표, 손익, AI 상태 및 실시간 통계 포함). 기본값: `켜기`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **10. AI 분석**

▸ **AI 필터 활성화** — 켜기/끄기

AI 필터를 활성화하거나 비활성화합니다. 꺼져 있으면 봇은 기술 분석만으로 작동합니다. 기본값: `꺼기`

▸ **AI 제공자** — 13개 제공자 중 선택

사용할 AI 제공자를 선택합니다. 각 제공자는 사전 구성된 URL과 모델을 가지고 있습니다. 기본값: `Anthropic`

▸ **API 키** — 문자열

선택한 제공자용 API 키입니다. Ollama(로컬 실행) 제외 모든 제공자에 필요합니다. Ollama 사용 시 빈칸으로 둡니다.

▸ **모델 (빈칸=기본값)** — 문자열

AI 모델 재정의입니다. 빈칸으로 두면 선택한 제공자의 기본 모델을 사용합니다. 특정 모델 테스트에 유용합니다 (예: "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **사용자 정의 API URL (빈칸=기본값)** — 문자열

API URL 재정의입니다. Ollama의 커스텀 포트, 기업 프록시 또는 커스텀 엔드포인트에 유용합니다.

▸ **최소 신뢰도 (%)** — 30 ~ 95

거래 승인에 필요한 AI 신뢰도 최소 임계값입니다. AI가 이 점수 미만을 반환하면 모든 기술 신호가 유효해도 거래가 차단됩니다. 기본값: `65`

▸ **실패 시 허용 (오류 시 허용)** — 켜기/끄기

AI 실패 시(타임아웃, API 다운, 잘못된 응답) 동작입니다. 켜기 = 거래가 계속 진행됨(실패 시 허용). 끄기 = 거래 차단(실패 시 차단). 기본값: `켜기`

▸ **거래 후 AI 검토** — 켜기/끄기

활성화하면 각 거래 종료 후 봇이 결과 세부 정보를 AI에 보내 평가, 등급(좋음/중립/나쁨) 및 교훈을 제공합니다. 모든 내용은 콘솔에 기록됩니다. 기본값: `켜기`

▸ **AI에 보낼 가격 바 수** — 5 ~ 25

분석 컨텍스트에 AI에 전송되는 최근 M15 캔들 수입니다. 바 수가 많을수록 컨텍스트가 풍부하지만 토큰 소비도 증가합니다. 기본값: `12`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 **차트 내 대시보드**

대시보드는 실시간으로 다음을 표시합니다:

— 현재 시장 상태 (추세 / 횡보)

— H4 편향 (강세 / 약세 / 횡보)

— ADX, ATR, H1 RSI 값

— 열린 포지션 / 최대치

— 열린 손익, 잔액, 자본

— 세션 상태 (활성 / 종료)

— 총 거래 수 및 승률 %

— AI 상태: 제공자, 마지막 결정, 신뢰도

— AI 호출 횟수 및 차단된 거래

색상은 자동으로 변경됩니다: 손익이 양수일 때 🟢 녹색, 음수일 때 🔴 빨간색.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 **기술 참고 사항**

— 권장 타임프레임: **M15** (다른 TF 사용 시 봇이 경고)

— `AccessRights.None` — 특별 권한 불필요

— AI 호출에 cTrader 기본 `Http.Send()` 사용

— cTrader 4.2+ (.NET 6) 호환

— 백테스트(비 AI) 및 실거래(유무 AI 모두) 지원

— 봇 포지션은 `AiUS500Pro` 라벨로 식별

— 수동 포지션이나 다른 봇과 간섭하지 않음

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ **면책 조항**

이 cBot은 교육 및 정보 제공 목적으로만 제공됩니다. 지수 거래는 상당한 자본 손실 위험이 있습니다. 과거 결과가 미래 수익을 보장하지 않습니다. AI 통합은 필터링을 개선하지만 위험을 제거하지는 않습니다. 실계좌 사용 전 반드시 데모 계좌에서 테스트하세요. 거래 결정은 전적으로 사용자 책임입니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━