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

애플리케이션 초기 설정

⚙️ MagicTradeBot v6.0 — 설정 시스템

MagicTradeBot v6.0은 완전히 새롭게 설계된 설정 시스템을 도입했습니다. 모든 설정은 모듈화되고 구조화되어 있으며 /settings 디렉토리 안에 위치합니다.

💡 추천: YAML을 수동으로 편집하는 대신 GUI 봇 설정 도구를 사용하세요:
https://magictradebot.com/en/bot-configuration

⚠️ 수동 편집은 고급 사용자용입니다.

📁 설정 구조

/settings/
├── application.yaml
├── connection.yaml
├── trading.yaml
├── position_sizing.yaml
├── money_management.yaml
├── risk_limits.yaml
├── order_execution.yaml
├── decision_engine.yaml
├── signal_registry.yaml
├── tradeview.yaml
├── market_data.yaml
├── market_watch.yaml
├── whale_tracking.yaml
├── dca.yaml
├── trading_gap_rules.yaml
├── excluded_symbols.yaml
├── manual_trade.yaml
└── notifications.yaml

각 파일은 봇의 특정 하위 시스템을 제어하며, 세밀한 튜닝과 유지보수성을 향상시킵니다.


🧠 핵심 설정 모듈

🔧 application.yaml

전역 애플리케이션 설정, 환경 설정, 거래 모드 제한.

🔌 connection.yaml

데이터베이스(SQLite/PostgreSQL) 및 Redis 설정.

📊 trading.yaml

핵심 거래 동작, 레버리지, 실행 규칙.

📈 position_sizing.yaml

자본 배분 엔진 (고정, %, 켈리 기준, 리스크 기반).

💰 money_management.yaml

거래 진행 전략 (피보나치, 마틴게일 등).

⚠️ risk_limits.yaml

강제 손절 및 익절 설정.

⚡ order_execution.yaml

주문 실행 방식 (시장가, 지정가, 슬리피지 제어).

🧠 decision_engine.yaml

50개 이상의 거래 조건을 가진 고급 규칙 엔진.

📡 signal_registry.yaml

신호 라우팅 및 실행 제어.

📺 tradeview.yaml

TradingView 웹훅 신호 통합.


📊 시장 & 전략 모듈

  • market_data.yaml — 캔들/차트 데이터 처리
  • market_watch.yaml — 변동성 모니터링 및 자동 거래
  • dca.yaml — 달러 코스트 애버리징 시스템
  • trading_gap_rules.yaml — 동적 트레일링 수익 로직
  • whale_tracking.yaml — Hyperliquid 고래 카피 트레이딩

🧩 제어 & 유틸리티 모듈

  • excluded_symbols.yaml — 특정 페어 거래 제외
  • manual_trade.yaml — 조건부 수동 거래 삽입
  • notifications.yaml — 알림 (Telegram, Discord 등)

🔐 환경 변수 (권장)

API 키 및 민감한 정보는 절대 YAML 파일에 저장하지 마세요. 대신 환경 변수를 사용하세요.

# 예시
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret
⚠️ 환경 변수는 항상 YAML 설정보다 우선됩니다.

⚠️ 중요 거래소 모드 제한

  • Bybit: 원웨이 모드만 지원 (헤지 모드 미지원)
  • Binance: 헤지 모드 지원
  • Bitget: 헤지 모드 지원
  • OKX: 헤지 모드 지원

잘못된 모드를 사용하면 다음 문제가 발생할 수 있습니다:

  • 주문 실행 실패
  • 잘못된 손익 계산
  • 리스크 관리 불일치

🚀 빠른 시작 (v6.0)

  1. 봇 설정 도구 열기
  2. GUI로 전략 구성
  3. YAML 설정 내보내기
  4. /settings 디렉토리 교체
  5. .env로 API 키 설정
  6. MagicTradeBot 실행
✅ 데이터베이스 불필요 (SQLite 기본)
✅ 백엔드 설정 불필요
✅ 완전히 모듈화되고 확장 가능
+