애플리케이션 초기 설정

⚙️ 애플리케이션 설정

새로운 MagicTradeBot은 관리 백엔드, 데이터베이스 또는 복잡한 설치가 필요 없습니다. 간단한 YAML 및 JSON 설정 파일로 경량 자가 호스팅 애플리케이션으로 바로 실행됩니다. 이는 자원을 매우 효율적으로 사용하며 기술적 및 비기술적 사용자 모두에게 적합합니다.

전통적인 데이터베이스 대신 모든 설정과 로그는 구조화된 파일에 저장됩니다. 텍스트 편집기나 IDE를 사용하여 직접 편집할 수 있습니다.

📁 설정 파일 개요

  • appsettings.yaml — 핵심 봇 및 거래소 설정.
  • tradesettings.yaml — 트레이딩 로직, 신호 처리, 자동화 설정.
  • symbols.json — 거래소의 심볼 동기화 및 추적 관리.
  • opentrades.yaml — 오픈 포지션 추적을 위한 시스템 파일 (편집 금지).
  • completedorders.yaml — 완료된 거래 및 손익 요약 기록.

테스트를 위해 데모 모드에서 봇을 실행하거나, 트레이딩 전략을 조정하거나, 실제 API 키로 실시간 거래를 시작할 수 있습니다. 실시간 거래를 시작하기 전에 항상 설정을 검토하세요.

🧠 핵심 봇 설정 (appsettings.yaml)


# ===========================================================
# MagicTradeBot 설정 파일 (appsettings.yaml)
# ===========================================================

Exchange:
  Name: "binance"     # 지원: binance, okx, bitget, bybit, hype | hyperliquid
  APIKEY: ""          # 중앙화된 거래소용 API 키
  APISECRET: ""       # API 시크릿 또는 개인 키 (Hyperliquid의 경우 지갑 키 사용)
  Passphrase: ""      # 일부 거래소에서만 필요 (OKX, Bitget)

# 환경 변수 대안 (권장)
# 파일에 자격 증명을 저장하지 않으려면 BINANCE_API_KEY, OKX_API_KEY 등을 사용하세요.

# -----------------------------------------------------------
# 라이선스 설정
# -----------------------------------------------------------
License:
  Key: "your_license_here" # 유효한 라이선스 키를 입력하세요
  # 생성, 연장 또는 업그레이드: https://magictradebot.com

# -----------------------------------------------------------
# 일반 애플리케이션 설정
# -----------------------------------------------------------
General:
  BotName: "MyBot01"
  DemoMode: true          # true = 시뮬레이션 모드
  DebugMode: false
  Timezone: "UTC"

# -----------------------------------------------------------
# Kline / 시장 데이터 설정
# -----------------------------------------------------------
Kline:
  RefreshInterval: 3
  maxKlineLength: 30
  chunkSize: 20
  refreshRate: 7
  summaryInterval: "3m"
  strategyIntervals:
    scalp: ["3m"]
    day: ["15m", "30m", "1h", "2h"]
    swing: ["1h", "2h", "4h", "6h"]
    long: ["1d"]
    default: ["5m", "15m", "1h"]

# -----------------------------------------------------------
# 요청 제한
# -----------------------------------------------------------
rateLimits:
  maxRequestsPerSecond: 10
  safeBuffer: 0.2

# -----------------------------------------------------------
# 브로드캐스트 / 알림 채널
# -----------------------------------------------------------
BroadCast:
  whatsapp_token: null
  whatsapp_phone_id: null
  discord_webhook_url: null
  instagram_token: null
  telegram_bot_token: null
  telegram_chat_id: null

✅ 트레이딩 모드, 신호 처리, 자금 관리 등에 대한 전체 설정 세부 정보 및 고급 조정을 위해 설정 섹션을 방문하세요.

🤖 트레이딩 로직 및 신호 설정 (tradesettings.yaml)

이 파일은 트레이딩 프로필, 신호 규칙, 스마트 손절매/이익실현 동작, 자금 관리 전략을 정의합니다. 스캘프, 스윙 또는 장기 트레이딩 모드를 완전한 제어로 실행할 수 있습니다. 


# MAGIC TRADE BOT - 트레이딩 설정
# --------------------------------

General:
  Profile: "scalp"
  BaseCurrency: "USDT"
  SyncSymbolsOnStartup: true
  InitialTradeAmount: 100.0
  Leverage: 5
  MaxOpenTrades: 10
  MoneyManagementStrategy: 0

SignalSettings:
  enable_extreme_volatility: true
  supported_volatility_action:
    - "BUY"
    - "SELL"
    - "PUMP"
    - "CRASH"
  enable_fisher_only_detection: true
  pump_multiplier: 0.04
  crash_multiplier: 0.025

SLTPSettings:
  StopLossPercent: 0.0
  TakeProfitPercent: 0.0
  EnableTrailingSl: false
  EnableBreakeven: false
  EnableTrailingTp: false

IntelligentRuleOptions:
  IsEnabled: true
  UseOriginalTPAsBase: false
  CandleExitRules:
    IsEnabled: false

IntelligentGlobalSettings:
  MinProfitToEnableTP: 0.0
  MaxLossBeforeForceClose: -30.0

💡 각 섹션은 개별적으로 사용자 정의하거나 비활성화할 수 있습니다. 봇은 이러한 설정에 따라 트레이딩 로직을 동적으로 조정합니다. 사용 가능한 모든 필드를 탐색하려면 트레이딩 설정 문서를 확인하세요.

📦 심볼 관리 (symbols.json)

봇은 연결된 거래소에서 거래 가능한 모든 심볼(예: Binance 500개 이상의 쌍)을 자동으로 동기화할 수 있습니다. 동기화를 비활성화하거나 특정 트레이딩 쌍으로 제한할 수 있습니다. 


{
  "syncEnabled": true,
  "includeSymbols": ["BTCUSDT", "ETHUSDT"],
  "excludeSymbols": ["USDCUSDT"]
}

특정 시장에 맞게 트레이딩 전략을 세밀하게 조정하기 위해 레버리지, 쿨다운 또는 트리거에 대한 심볼별 설정을 정의할 수도 있습니다.

💾 시스템 파일

  • opentrades.yaml — 현재 활성 거래를 저장합니다. 수동으로 수정하지 마세요.
  • completedorders.yaml — 보고서 및 성과 추적을 위해 거래 기록과 손익 결과를 기록합니다.

이 파일들은 봇이 재시작 후 안전하게 재개하고 실시간 및 데모 세션 간의 일관성을 유지하는 데 도움을 줍니다.

🚀 빠른 시작 요약

  • MagicTradeBot 패키지를 다운로드하세요.
  • appsettings.yaml 및 tradesettings.yaml을 편집하세요.
  • 거래소 API 키를 추가하거나 환경 변수를 통해 설정하세요.
  • 봇을 실행하세요 — 심볼을 자동으로 로드하고, 스캔을 시작하며, 거래를 관리합니다.

📎 Related Topics