🚀 TradeCopierBot — 빠르고 깔끔하며 브로커에 안전한 거래 복사기 (로컬/VPS) 🔁✨

거래를 MASTER 계정에서 하나 이상의 SLAVE 계정으로 복사하는 경량 이벤트 기반 복사기입니다. 실제 거래 조건에 맞게 설계되었습니다: 다른 브로커, 다른 심볼 이름, 다른 로트 규칙.
다중 계정 실행에 완벽하며, 위험 규모 조정, 그리고 전략 분배에 적합하며, 상세한 디버그 로그를 통해 항상 무슨 일이 일어나고 있는지 알 수 있습니다. 🧠📈

✅ 로컬 / VPS 설정에 최적화됨 (같은 기기).
❌ cTrader Cloud 용으로 설계되지 않음 (인스턴스가 격리되어 신호를 공유할 수 없음). ☁️🚫

주의: 서로 다른 cTrader 계정이 두 개 있다면, cBot도 두 개 구매해야 합니다; 그렇지 않으면 복사할 수 없습니다. 문의 사항이 있으면 언제든지 도와드리겠습니다.

🧠 작동 방식 (MASTER → SLAVE) 🧩

🔁 1) 신호 전송 (거래가 “이동”하는 방식)

이 복사기는 cTrader LocalStorage (기기 범위)를 공유 “메시지 버스”로 사용합니다.

✅ MASTER

• 포지션 이벤트 수신: 열림 / 수정 / 닫힘
• 다음과 같은 TradeSignal 생성 (OPEN / MODIFY / CLOSE)
• 이를 signals list에 추가함 (LocalStorageScope.Device 내)
• SLAVE가 즉시 읽을 수 있도록 Flush() 호출

✅ SLAVE

• 매 Poll Interval 초마다 Timer 실행
• Reload() 호출
• signals list 읽기
• 오직 새 신호만 처리 (_lastSignalIndexProcessed 사용)

🧷 2) 포지션 매핑 (CLOSE 작동을 위해)

SLAVE가 거래를 열 때 저장하는 내용:

🧩 MasterPositionId → SlavePositionId

이 매핑은 LocalStorage에도 저장되어 재시작 후에도 유지됩니다:

• ✅ 재부팅 후에도 CLOSE 작동
• ✅ MODIFY가 올바른 포지션을 찾음

🧭 3) 심볼 변환 (MASTER 심볼 → SLAVE 심볼)

🗺️ 심볼 맵 (MASTER=SLAVE;...)

브로커/계정 간 심볼 이름이 다를 때 사용.

형식:

• MASTER=SLAVE;MASTER2=SLAVE2;...

예시 (사용자 사례):

• MASTER가 USTEC 열림
• SLAVE는 US100 거래해야 함

➡️ USTEC=US100

✅ 왼쪽 = MASTER에서 오는 심볼
✅ 오른쪽 = SLAVE 브로커의 심볼

📏 4) 거래량 로직 (핵심 부분) 🔥

✅ 로트/수량 단위로 작동 (소수점 지원)

소수점(0.10, 0.01 등)을 처리하기 위해 SLAVE는:

• 원하는 로트 수 계산
• 곱셈기 / 최소값 / 단계 적용
• 로트를 거래량으로 변환 (QuantityToVolumeInUnits(lots) 사용)
• double 거래량을 받는 오버로드를 사용해 주문 전송 ✅

이 덕분에 브로커가 서로 다른 로트 정밀도 규칙을 적용해도 견고하게 작동합니다.

⚙️ 매개변수 설명 (아이콘 포함)

🧩 핵심

• 🧭 모드
• • Master = 신호 발행
  • Slave = 신호 수신 및 거래 복사
• 🧷 복사 그룹 ID
• • 통신 채널. MASTER와 SLAVE가 일치해야 함 (예: DEFAULT)
• ⏱️ 폴링 간격 (초)
• • SLAVE가 N초마다 새 신호 확인
• 🐞 디버그 모드
• • 상세 로그 출력 (설정 시 권장)

🗺️ 심볼 변환

• 🧾 심볼 맵 (MASTER=SLAVE;...)
• • 예: USTEC=US100;XAUUSD=GOLD;NAS100=USTEC

🎚️ 거래량 조정 (가장 중요) ✅

🔢 전역 곱셈기

• ➗ 거래량 곱셈기
• • 복사된 모든 로트에 적용:
  • desiredLots = masterLots * VolumeMultiplier

🎛️ 심볼별 곱셈기 (주요 도구)

• 🧷 거래량 곱셈기 맵 (SYM=mult;...)
• • 심볼별 곱셈기 재정의 (SLAVE 측 심볼)
  • 예:
  • • US100= 0. 10
    • 이탈리아 형식도 가능: US100=0,10

✅ 이렇게 하면 다음을 달성할 수 있습니다: MASTER의 1.00 → SLAVE의 0.10

🧱 브로커 로트 제약 조건 (최소 및 단계)

• 🧱 최소 수량 기본값 (0=비활성)
• • 활성화 시 전역 최소 로트
• 🧱 최소 수량 맵 (SYM=val;...)
• • 심볼별 최소 로트
  • 예: US100=0. 10
• 🪜 수량 단계 기본값 (0=비활성)
• • 활성화 시 전역 단계
• 🪜 수량 단계 맵 (SYM=val;...)
• • 심볼별 단계
  • 예: US100=0. 10 → 허용 값: 0.10, 0.20, 0.30…

🧯 안전 동작

• 🧷 최소 수량을 고정 로트로 사용
• • 만약 true면: SLAVE는 마스터 크기를 무시하고 항상 MinQty 사용 (고정 크기)
• ⚠️ 최소 이하 동작
• • UseMin = 최소 이하일 경우 최소값으로 올림
  • Skip = 최소 이하일 경우 열지 않음
• 🔁 잘못된 거래량 시도
• • 브로커가 BadVolume을 반환하면 최대 N회까지 작은 조정 시도

🎯 SL/TP 복사 로직

• 🛡️ 심볼이 다를 때 SL/TP를 거리로 복사
• • MASTER와 SLAVE 심볼이 다르면:
  • SL/TP는 절대 가격이 아닌 진입점으로부터의 거리로 복사됨
  • 이렇게 하면 도구 간 위험 제어가 일관되게 유지됨

✅ 권장 설정 (USTEC → US100, SLAVE 로트 = 0.10)

SLAVE에서:

🗺️ 심볼 변환:

• Symbol Map = USTEC=US100

🎛️ 거래량 조정:

• Volume Multiplier Map = US100=0,10

🧱 브로커 제약 조건:

• Min Qty Map = US100=0,10
• Qty Step Map = US100=0,10

결과:

• ✅ MASTER 1.00 → SLAVE 0.10 (US100에서)

☁️ 중요: 로컬/VPS 전용 (클라우드 아님) ❌

🖥️ 로컬/VPS ✅

MASTER와 SLAVE가 동일한 LocalStorageScope.Device (같은 기기/환경)를 공유하기 때문에 작동함.

☁️ cTrader Cloud ❌

클라우드 인스턴스가 격리되어 LocalStorage를 공유하지 못하고 SLAVE가 MASTER 신호를 볼 수 없기 때문에 작동하지 않음.

✅ 결론:

• ✔️ 같은 PC 또는 두 인스턴스가 함께 실행되는 VPS에서 사용
• ❌ 클라우드에서는 외부 중계기(HTTP/WebSocket 서버)가 필요