アプリケーションの初期設定

⚙️ アプリケーション設定

新しい MagicTradeBot は、管理用バックエンドやデータベース、複雑なインストールを必要としません。 シンプルな YAML と JSON の設定ファイルを使用した 軽量なセルフホスト型アプリケーション として直接動作します。 これにより、リソース効率が非常に高く、技術者だけでなく非技術者にも適しています。

従来のデータベースの代わりに、すべての設定とログは構造化されたファイルに保存されます。 任意のテキストエディタや IDE で直接編集可能です。

📁 設定ファイルの概要

  • appsettings.yaml — ボットと取引所の基本設定。
  • tradesettings.yaml — 取引ロジック、シグナル処理、自動化設定。
  • symbols.json — 取引所のシンボル同期と追跡を管理。
  • opentrades.yaml — オープンポジションを追跡するシステムファイル（編集不可）。
  • completedorders.yaml — 完了した取引と PnL のサマリーを記録。

デモモードでボットをテストしたり、取引戦略を調整したり、実際の 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 — 取引履歴と PnL 結果を記録し、レポートやパフォーマンス追跡に使用。

これらのファイルにより、再起動後も安全にボットを再開でき、ライブとデモセッション間の一貫性を維持できます。

🚀 クイックスタート概要

  • MagicTradeBot パッケージをダウンロード。
  • appsettings.yaml と tradesettings.yaml を編集。
  • 取引所の API キーを追加、または環境変数で設定。
  • ボットを実行 — シンボルを自動で読み込み、スキャンを開始し、取引を管理。

📎 Related Topics