MagicTradeBotを初めて実行する前にどの設定を構成する必要がありますか？

初回セットアップガイド

MagicTradeBotを初めて起動する前に、ボットが正しく起動し、取引所に安全に接続し、エラーなく動作することを確実にするために、少数の必須および推奨設定を構成する必要があります。

MagicTradeBotは安全なデフォルト値で設計されているため、すべてのファイルを事前に構成する必要はありません。以下の手順は、スムーズな初回実行のために必要な最小限の推奨設定をカバーしています。

1. application.yaml で取引所を設定する

MagicTradeBotが接続する取引所を指定する必要があります。

Exchange:
  Name: "bybit"

サポートされている取引所：

Binance
Bybit
OKX
Bitget
Hyperliquid

⚠️ 重要： 各取引所には厳格なポジションモードの要件（One-Way vs Hedge）があります。ボットを実行する前に、取引所アカウントがそれに従って構成されていることを確認してください。

2. 取引所API認証情報を設定する（必須）

MagicTradeBotが取引を発注・管理するにはAPIアクセスが必要です。

推奨方法：環境変数（ベストプラクティス）

特に本番環境では、環境変数の使用を強くお勧めします。その理由は：

APIキーがファイルに保存されない
キーがより安全で、ローテーションが容易
環境変数はYAML値を自動的に上書きする

OS別環境変数の設定

✅ Windows (PowerShell)

setx BINANCE_API_KEY "ここにAPIキーを入力"
setx BINANCE_API_SECRET "ここにAPIシークレットを入力"

変数を設定した後、ターミナル（またはシステム）を再起動してください。

✅ Linux / macOS (ターミナル)

export BINANCE_API_KEY="ここにAPIキーを入力"
export BINANCE_API_SECRET="ここにAPIシークレットを入力"

永続的にするには、以下のファイルに行を追加します：

~/.bashrc
~/.zshrc
シェルプロファイルファイル

✅ Docker / Docker Compose

environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

サポートされている環境変数名

例：

BINANCE_API_KEY, BINANCE_API_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
HYPERLIQUID_PRIVATE_KEY

🔐 APIキーで出金権限を決して有効にしないでください。

3. ライセンスキーを入力する

application.yaml で：

License:
  Key: "ここにライセンスキーを入力"

ライセンスキーの取得方法

https://magictradebot.com にログイン
ダウンロードへ移動
ライセンスキーをコピー

重要な注意事項

ボットはライセンスがなくても実行できます
ただし、機能が制限されます
ライセンス検証は起動時に行われます

4. 基本取引設定を確認する (trading.yaml)

初めてのユーザーの場合、このファイルに必須の変更は必要ありません。

必要に応じて、以下を確認または調整できます：

初期取引金額
デフォルトレバレッジ
リスク制限

不明な場合は、デフォルト値のままにしてください。初期実行とデモモードでは安全です。

5. 初回のシンボルとレバレッジ設定（非常に重要）

ステップ1：シンボル同期を有効にする（初回実行のみ）

trading.yaml（またはシンボル設定ファイル）で：

SyncSymbolsOnStartup: true

これにより：

取引所からサポートされているすべてのシンボルを取得
symbols.json を作成または更新
上場廃止されたシンボルを削除
新規上場シンボルを追加

➡️ ボットを実行し、シンボル同期が完了するまで待機
➡️ symbols.json ファイルを監視
➡️ 同期が完了したらボットを停止

ステップ2：シンボル同期を無効にする（オプション）

最初の同期後、以下を設定できます：

SyncSymbolsOnStartup: false

自動シンボル更新が必要な場合は、永続的に true のままにします。

ステップ3：1回限りのレバレッジ設定（オプションですが推奨）

MagicTradeBotにレバレッジを自動設定させたい場合：

SetLeverageStartup: true
SetMaxLeverage: false

これにより、設定されたレバレッジ（例：10倍）がサポートされているすべてのシンボルに適用されます
ボットを一度実行します
レバレッジが更新されるまで数分待ちます
その後、両方のオプションを false に戻します

⚠️ これらのオプションを永続的に有効にしたままにしないでください。再起動のたびにレバレッジがリセットされます。

最大レバレッジ（スキャルピングのユースケース）

取引所で許可されている最大レバレッジが必要な場合：

SetMaxLeverage: true

これは一度だけ使用し、その後再度無効にしてください。

6. 取引するシンボルを選択する（オプション）

以下のことができます：

同期されたすべてのシンボル（500以上）を取引する
または、選択したシンボルのみに取引を制限する

例：

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

すべてのシンボルを取引する場合は、以下を維持します：

SyncSymbolsOnStartup: true

7. 通知を設定する（強く推奨）

notification.yaml で少なくとも1つの通知チャンネルを設定します：

Telegram
Discord

これにより、以下を受信できます：

取引実行
エラーと失敗
マーケットウォッチアラート
緊急イベント

通知なしでの実行は可能ですが、推奨されません。

最終チェックリスト（初回実行）

MagicTradeBotを起動する前に、以下を確認してください：

✅ application.yaml で取引所が選択されている
✅ API認証情報が設定されている（できれば環境変数経由で）
✅ ライセンスキーが追加されている（オプションだが推奨）
✅ 初回実行のためにシンボル同期が有効になっている
✅ オプションのレバレッジ設定が1回完了している
✅ 通知チャンネルが設定されている

以上です。
安全かつ正確に取引を開始するために必要なその他の設定はありません。