시작하기 · v6.0+ · Latest stable

⚡ MagicTradeBot 표준 거래 신호

MagicTradeBot v6.0에서는 신호 처리 방식이 완전히 재설계되었습니다. 핵심 시스템 내부에는 정적 신호 테이블이나 하드코딩된 매핑이 존재하지 않습니다. 모든 신호는 이제 /settings/signal_registry.yaml 설정 파일을 통해 관리됩니다.

이를 통해 각 신호의 동작 방식을 완전히 유연하게 정의할 수 있습니다 — 자동 거래 실행을 트리거할지, 아니면 브로드캐스트 알림으로만 사용할지 선택할 수 있습니다. 수동 편집 대신 Bot Configurator UI 사용이 강력히 권장됩니다.


⚙️ 신호 시스템 개요

MagicTradeBot v6.0은 두 가지 주요 카테고리를 갖는 통합 신호 처리 파이프라인을 지원합니다:

  • 자동 거래 실행 신호 → 전략 및 리스크 엔진 기반 실제 거래 실행
  • 브로드캐스트 / 알림 신호 → Telegram, Discord, UI 대시보드 등으로 알림 전송

모든 신호는 실행 또는 알림 계층으로 라우팅되기 전에 동일한 검증 엔진을 통과합니다.


🧠 신호 등록 시스템 (v6.0 핵심)

신호는 /settings/signal_registry.yaml 내부에 등록됩니다. 이 파일은 각 신호가 시스템에서 어떻게 동작하는지를 정확하게 정의합니다.


# ------------------------------------------------
# 주문 실행 신호 (실제 거래)
# ------------------------------------------------
register_trading_signals:
  - "LONG_PUMP_SIGNAL"
  - "SHORT_CRASH_SIGNAL"
  - "SHORT_CRASH_ACCELERATION_SIGNAL"
  - "SHORT_MOMENTUM_FORMING_CANDLE_SIGNAL"
  - "LONG_MOMENTUM_ACCELERATION_SIGNAL"
  - "LONG_MOMENTUM_FORMING_CANDLE_SIGNAL"
  - "TV_EMA_CROSS_LONG_EXTERNAL_SIGNAL"
  - "TOP_GAINER_LONG_SIGNAL"
  - "TOP_GAINER_SHORT_SIGNAL"
  - "TOP_LOSER_SHORT_SIGNAL"
  - "TOP_LOSER_LONG_SIGNAL"

# ------------------------------------------------
# 브로드캐스트 / 알림 신호 (거래 없음)
# ------------------------------------------------
register_broadcast_signals:
  - "LONG_PUMP_SIGNAL"
  - "SHORT_CRASH_SIGNAL"
  - "SHORT_CRASH_ACCELERATION_SIGNAL"
  - "SHORT_MOMENTUM_FORMING_CANDLE_SIGNAL"
  - "LONG_MOMENTUM_ACCELERATION_SIGNAL"
  - "LONG_MOMENTUM_FORMING_CANDLE_SIGNAL"
  - "TV_EMA_CROSS_LONG_EXTERNAL_SIGNAL"
  - "TOP_GAINER_LONG_SIGNAL"
  - "TOP_GAINER_SHORT_SIGNAL"
  - "TOP_LOSER_SHORT_SIGNAL"
  - "TOP_LOSER_LONG_SIGNAL"

📡 신호 유형 설명

1. 자동 거래 실행 신호

이 신호들은 봇의 리스크 엔진, 자금 관리 시스템, 전략 로직을 통해 실제 거래를 실행합니다.

  • 실행 전 의사결정 엔진에 의해 검증됨
  • 손절(SL), 익절(TP), DCA, 트레일링 로직과 완전히 통합됨
  • 거래소 제약 및 포지션 규칙을 준수

2. 브로드캐스트 신호 (모니터링 전용)

이 신호들은 거래를 실행하지 않습니다. 다음 용도로 사용됩니다:

  • Telegram / Discord 알림
  • 대시보드 시각화
  • 수동 거래 판단 지원

📊 TradingView 신호 형식

TradingView 신호는 다음 표준 형식을 사용합니다:


TV_{STRATEGY}_{DIRECTION}_EXTERNAL_SIGNAL

예시:


TV_EMA_CROSS_LONG_EXTERNAL_SIGNAL

이러한 신호는 TradingView Signal Bridge를 통해 시스템에 주입됩니다.


🌉 TradingView 신호 브리지 (필수)

v6.0에서는 TradingView 신호가 봇에서 직접 처리되지 않습니다. 대신 반드시 TV Signal Bridge를 거쳐야 합니다.

  • TradingView 웹훅 알림 수신
  • 신호 형식 검증 및 정규화
  • 봇 실행 엔진으로 신호 전달
  • 안정적이고 구조화된 신호 전달 보장

TV Signal Bridge가 제대로 설정되지 않으면 TradingView 신호는 실행되지 않습니다.


⚠️ v6.0 주요 변경 사항

  • 핵심 봇 로직 내부의 레거시 신호 테이블 제거
  • 모든 신호는 signal_registry.yaml에 명시적으로 등록해야 함
  • Bot Configurator UI 기반 관리 방식 권장
  • 신호 동작은 전략 로직과 완전히 분리됨

🚀 요약

MagicTradeBot v6.0은 완전히 모듈화된 신호 아키텍처를 도입하여, 모든 신호가 명시적으로 정의되고 설정 가능한 실행 또는 브로드캐스트 파이프라인을 통해 라우팅됩니다.

이를 통해 거래 결정이 어떻게 트리거되고 모니터링되는지에 대한 유연성, 투명성, 그리고 제어력이 극대화됩니다.

+