应用程序初始配置

⚙️ 应用程序配置

新的 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"

# -----------------------------------------------------------
# K线 / 市场数据配置
# -----------------------------------------------------------
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