インストールガイド

前提条件

• Docker Desktop（Redisを使用する場合のみ必要）
• APIキーを持つ対応取引所アカウント
• サーバーの公開IPアドレス（APIホワイトリスト用）

目次

1. ボット設定
2. APIキー設定
3. Redisのセットアップ
4. RedisMarketBridge
5. ボットの起動
6. トラブルシューティング
7. TradingView連携

1. ボット設定

すべての設定はオンラインのコンフィギュレーターで行います。

1. 開く：Configurator
2. MagicTradeBot を選択
3. 設定項目：

設定のエクスポート：

1. Export All YAML をクリック
2. 解凍（Unzip）
3. プロジェクト内の /settings フォルダを置き換える

magictradebot/
├── settings/  ← 置き換え
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. APIキー設定

🔐 セキュリティ： 必ず環境変数を使用してください。設定ファイルにAPIキーを保存しないでください。

IPホワイトリスト登録

curl ifconfig.me

このIPを取引所のAPIホワイトリストに追加してください。

.envの使用

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ .env を .gitignore に追加してください

3. Redisのセットアップ（オプション）

Redisが有効な場合のみ必要です。

DockerでRedisを起動

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

確認

docker exec -it magictradebot-redis redis-cli ping

期待される結果：PONG

4. RedisMarketBridge

このコンポーネントはリアルタイム市場データをRedisに送信します。

⚠️ 取引所 + ペア + 時間足はボット設定と完全に一致している必要があります

手順：

1. コンフィギュレーターで設定
2. YAMLをエクスポート
3. adapters/redismarketbridge/settings を置き換え

5. ボットの起動

起動順序

1. Redisを起動
2. RedisMarketBridgeを起動
3. 2分待機
4. MagicTradeBotを起動

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 ログ確認のためターミナルから実行してください

6. トラブルシューティング

APIエラー

• IPホワイトリストを確認
• 権限を確認
• 環境変数を確認

マーケットデータがない

• RedisMarketBridge起動後2分待つ
• 設定の一致を確認

Redisの問題

• Dockerが起動しているか確認
• ポート6379が開いているか確認

7. TradingViewシグナル連携

MagicTradeBotはTradingViewからの外部シグナルをWebhook経由でサポートします。

仕組み

• TradingViewがアラート送信 → Webhook
• MagicTradeBotがシグナル受信
• 自動で取引を実行

ステップ1 — ボットでWebhookを有効化

ボット設定内：

• Signals → Webhook を有効化
• Webhook URLをコピー

例：

http://your-server:port/webhook

ステップ2 — TradingViewアラート作成

1. TradingViewチャートを開く
2. インジケーターまたはストラテジーを追加
3. Alert をクリック
4. Webhook URL を有効化
5. ボットのWebhook URLを貼り付け

ステップ3 — アラートメッセージ定義

JSON例：

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

対応アクション

• buy
• sell
• close

重要事項

• シンボルはボット設定と完全一致させること
• 時間足を正しく合わせること
• まずは少額でテストすること

⚠️ 不正なペイロード形式 = シグナルは無視されます

テスト

Webhookのテスト：

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ 正しく設定されていれば、ボットが取引を実行します

💡 詳細は公式TradingViewドキュメントを参照してください。