MagicTradeBot v6.0 — RedisMarketBridge 統合ガイド

リアルタイム市場データ。ボットごとのAPIコールゼロ。レート制限リスクなし。

目次

1. はじめに
2. アーキテクチャの概要
3. 前提条件
4. インストール & セットアップ
5. MagicTradeBotでのRedisの有効化
6. 複数ボットの実行
7. Redisキースキーマ
8. デプロイメントパターン
9. シグナルエンジンの設定
10. トラブルシューティング
11. Proへのアップグレード
12. クイックリファレンス

1. はじめに

MagicTradeBot v6.0は、ネイティブなRedis統合を導入し、複数のボットを同時に実行するための根本的に新しいアーキテクチャを可能にします。RedisMarketBridgeを共有マーケットデータレイヤーとして接続することにより、フリート内のすべてのボットが、取引所APIを直接呼び出す代わりにRedisからライブマーケットデータを読み取ります — 実行中のボットの数に関係なく。

なぜこれが重要なのか

Redisなしの場合: Binanceで10ボット = 10倍のレート制限消費。100ボット = ほぼ確実なスロットリング。

Redisありの場合: Binanceで1,000ボット = RedisMarketBridgeが使用するのと同じ1つのレート制限スロット。あなたのボットは取引所から見えません。

RedisMarketBridgeは唯一の信頼できる情報源です。すべてのボットはそこからマイクロ秒でデータを消費します — ネットワークの往復なし、ボットごとのAPIキーも不要です。

1.1 RedisMarketBridgeとは

RedisMarketBridgeは、セルフホスト型のオープンソース（MIT）マーケットデータパイプラインで、以下の機能を持ちます：

• 専用の並列ワーカーを使用して、同時に最大12の取引所に接続
• ティッカー、ローソク足、ファンディングレート、オーダーブックの動き、取引所間スプレッドなどの市場データを取得・正規化
• 6フェーズのパイプラインを通じてデータを処理 — 生のティックから構造化されたTTL管理シグナルまで
• どの言語でも読み取り可能な一貫したキースキーマを使用してすべてをRedisに書き込み
• シグナル（RSI、MACD、ボリンジャーバンド、VWAP、CVD、OFI）を計算し、生データとともに保存

1.2 MagicTradeBot v6.0での使用方法

MagicTradeBotでRedisモードが有効になっている場合、各ボットインスタンスはデータ取得戦略を変更します：

トレーディングロジック、シグナル処理、注文配置、リスク管理は変更されていません。データ取り込みレイヤーだけが変化します — そしてパフォーマンスの差は劇的です。

2. アーキテクチャの概要

2.1 フルスタック

Binance API   ──→  RMBワーカースレッド  ──┐
Bybit API     ──→  RMBワーカースレッド  ──┤
Gate.io API   ──→  RMBワーカースレッド  ──┤
HTX API       ──→  RMBワーカースレッド  ──┤  →  Redis（唯一の信頼できる情報源）
KuCoin API    ──→  RMBワーカースレッド  ──┤
Kraken API    ──→  RMBワーカースレッド  ──┤
… 合計12      ──→  RMBワーカースレッド  ──┘
                                             ↓
                          ┌──────────────────────────────┐
                          │  MagicTradeBot Bot 1          │
                          │  MagicTradeBot Bot 2          │  すべてRedisから読み取り
                          │  MagicTradeBot Bot 3          │  取引所への直接コールはゼロ
                          │  MagicTradeBot Bot N  (∞)     │
                          └──────────────────────────────┘

すべてのボットはRedisから読み取ります。ボットコードからの直接の取引所APIコールはゼロです。取引所はRedisMarketBridgeとのみ通信します。

2.2 6フェーズパイプライン

RedisMarketBridgeは、ボットに到達する前にマーケットデータを6つの連続したフェーズで処理します：

3. 前提条件

3.1 必要なソフトウェア

3.2 取引所 API キー

RedisMarketBridgeはマーケットデータに公開エンドポイントのみを使用します — ティッカー、ローソク足、ファンディングレートにAPIキーは不要です。APIキーはオプションで、以下の場合にのみ必要です：

• 一部の取引所（Binance、OKX）でのレート制限の引き上げ
• プライベートデータへのアクセス（マーケットデータパイプラインでは使用されません）
• 有効な場合の将来のトレーディング機能

⚠️ 重要 — ボットAPIキー

MagicTradeBotは注文配置のために取引所APIキーを依然として必要とします。マーケットデータの取り込みのみがRedisMarketBridgeにオフロードされます。ボットのAPIキーは、注文の配置、監視、キャンセルにのみ使用されます。

4. インストール & セットアップ

4.1 ステップ 1 — Redisの起動

最も簡単な方法はDocker Composeです。docker-compose.ymlを作成します：

version: '3.8'
services:
  redis:
    image: redis:7-alpine
    container_name: rmb-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    command: redis-server --maxmemory 2gb --maxmemory-policy allkeys-lru
    restart: unless-stopped

volumes:
  redis-data:

docker compose up -d redis
# 確認:
redis-cli ping   # → PONG

4.2 ステップ 2 — RedisMarketBridgeのダウンロード

無料ティア（オープンソース、MIT）:

git clone https://github.com/magictradebot/redis-market-bridge
cd redis-market-bridge
cargo build --release
# バイナリ: ./target/release/redis-market-bridge

Proティア（バイナリダウンロード）:

magictradebot.comでProライセンスを購入した後、お使いのOS用のプレビルドバイナリをダウンロードしてください。ビルドステップは不要です。同じバイナリが無料機能でも動作します — ライセンスキーによりPro機能が即座に有効になります。

4.3 ステップ 3 — RedisMarketBridgeの設定

すべての設定はsettings/ディレクトリにあります：

connection.yaml — Redis接続

Redis:
  Host: "127.0.0.1"    # またはお使いのRedisサーバーIP
  Port: 6379
  Password: ""          # Redis認証が有効な場合に設定
  TLS: false
  Database: 0
  PoolSize: 20          # ボット数が多い場合は増やす

exchanges.yaml — 取引所設定

有効にする各取引所のコメントを解除してください。すべてのマーケットデータエンドポイントは公開されています — APIキーはオプションです：

Exchanges:

  - Name: "binance"
    Credentials:
      ApiKey: ""        # オプション — より高いレート制限のため
      ApiSecret: ""
    Proxy:
      Enabled: false

  - Name: "bybit"
    Credentials:
      ApiKey: ""
      ApiSecret: ""

  # Proティア — 有効にするにはコメントを解除:
  #- Name: "okx"
  #  Credentials:
  #    ApiKey: ""
  #    ApiSecret: ""
  #    Passphrase: ""   # OKXに必要

  #- Name: "gateio"
  #- Name: "htx"
  #- Name: "kucoin"    # パスフレーズが必要
  #- Name: "kraken"
  #- Name: "bingx"
  #- Name: "phemex"
  #- Name: "mexc"      # ⚠️ 注意：2026年3月再開 — 慎重に監視してください
  #- Name: "hyperliquid"

⚠️ MEXC注意事項

MEXC先物APIは2022年から2026年までオフラインで、2026年3月に再開されました。 RedisMarketBridgeは起動時とMEXCデータ書き込みごとに警告を表示します。初期安定化期間中はMEXCデータを注意深く監視してください。

application.yaml — エンジンモード

Engine: "Both"   # MarketBridge | SignalBridge | Both

License:
  Key: ""         # Proライセンスキー（無料ティアの場合は空白のまま）

General:
  DebugMode: false
  RenderDashboard: true

4.4 ステップ 4 — RedisMarketBridgeの起動

# ブリッジを起動:
./redis-market-bridge

# またはDocker Composeで — docker-compose.ymlに追加:
# services:
#   rmb:
#     image: magictradebot/redis-market-bridge:latest
#     volumes:
#       - ./settings:/app/settings
#     depends_on: [redis]
#     restart: unless-stopped

期待される起動出力:

[RMB] RedisMarketBridge v1.0を起動中
[RMB] エンジンモード: Both
[RMB] Redis: 127.0.0.1:6379 接続済み ✓
[RMB] ワーカーを生成: binance
[RMB] ワーカーを生成: bybit
[RMB] ワーカーを生成: bitget
[フェーズ1] シンボル同期: BINANCE=665 BYBIT=542 BITGET=544
[フェーズ1] シンボル同期完了 — Redis内の1,751シンボル
[フェーズ3] ティックデータストリーミング — サイクル5秒
[フェーズ6] シグナルエンジンアクティブ — RSI MACD BB VWAP

5. MagicTradeBotでのRedisの有効化

5.1 Redis設定

MagicTradeBotの設定を開き、Redisセクション（v6.0で新規）を見つけます：

# MagicTradeBot v6.0 — settings/connection.yaml

Redis:
  Enabled: true                    # trueに設定してRedisモードを有効化
  Host: "127.0.0.1"               # RedisMarketBridgeと同じRedisインスタンス
  Port: 6379
  Password: ""
  TLS: false
  Database: 0
  ConnectionPool: 10               # ボットインスタンスごとのプールサイズ

  # Redisが利用できない場合のフォールバック動作:
  FallbackToDirectApi: true        # Redisキーがない場合は直接API呼び出しにフォールバック
  FallbackWarningLog: true         # フォールバックごとに警告をログに記録
  FallbackStaleThresholdMs: 30000  # 30秒以上経過したデータを古いものとして扱う

5.2 Redis有効時の変更点

✅ フォールバック保護

Redisキーがないか期限切れの場合（例：RedisMarketBridgeがダウンしている）、MagicTradeBotはその特定のデータポイントに対して自動的に直接取引所API呼び出しにフォールバックします。これにより、データレイヤーの障害によってボットが停止することはありません。無効にするにはFallbackToDirectApi: falseを設定します（本番環境では推奨しません）。

6. 複数ボットの実行

6.1 中核的利点

6.2 単一取引所 — 複数ボット

すべてBinance USDTパーペチュアルをターゲットとする20の異なる戦略ボットを実行：

# bot-1-btc.yaml  （Long/Short BTC、15mシグナル）
Exchange: "binance"
Symbol: "BTCUSDT"
Strategy: "momentum"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# bot-2-eth.yaml  （Long/Short ETH、30mシグナル）
Exchange: "binance"
Symbol: "ETHUSDT"
Strategy: "mean_reversion"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# ... 必要なだけボットを繰り返す
# すべて同じRedisから読み取り — BinanceはRMBの単一接続のみを見る

6.3 複数取引所 — 複数ボット

5つの異なる取引所で同時にボットを実行。Redisなしでは、全ボットにわたって5つの個別のレート制限予算を管理する必要があります。Redisありの場合：

# bot-binance-sol.yaml
Exchange: "binance"
Symbol: "SOLUSDT"
Redis: { Enabled: true, Host: "127.0.0.1" }

# bot-bybit-sol.yaml  （同じシンボル、異なる取引所 — アービトラージ比較）
Exchange: "bybit"
Symbol: "SOLUSDT"
Redis: { Enabled: true, Host: "127.0.0.1" }

# bot-gateio-arb.yaml  （Redisから取引所間アービトラージシグナルを読み取り）
Exchange: "gateio"
Symbol: "SOLUSDT"
Strategy: "funding_arb"
Redis:
  Enabled: true
  Host: "127.0.0.1"
  UseArbSignals: true       # 事前計算されたarb:signal:SOLUSDTをRedisから読み取り

💡 取引所間アービトラージボット

ArbEdgeBot（MagicTradeBotのファンディングアービトラージモジュール）はRedisから最も恩恵を受けます。事前計算された取引所間ファンディングギャップスコアをarb:signal:__top__から読み取ります — スプレッド＋モメンタム＋流動性ウェイトでランク付けされたトップN機会を含む単一のキーです。必要なAPIコールはゼロです。

7. Redisキースキーマ

MagicTradeBotは、RedisMarketBridgeによって書き込まれた一貫したキースキーマを使用してRedisからデータを読み取ります。

7.1 キーリファレンス

7.2 Redis CLI検査の例

redis-cli

# ブリッジが書き込んでいるか確認:
> KEYS tick:binance:*
1) "tick:binance:BTCUSDT"
2) "tick:binance:ETHUSDT"
... 665件の結果

# 現在のBTC価格を取得:
> GET tick:binance:BTCUSDT
{"price":67284.1,"vol24h":1842311490,"bid":67283.5,"ask":67284.7}

# SOLUSDTのファンディングレートを取得:
> GET funding:bybit:SOLUSDT
{"rate":-0.00871,"next":1734567890000,"anomaly":true}

# ETHUSDT 30mのRSIを取得:
> GET signal:binance:ETHUSDT:30m
{"rsi":42.3,"macd":-12.4,"bb_pct":0.31,"cvd":-184200}

# トップアービトラージシグナルを取得（ArbEdgeBotが読み取り）:
> GET arb:signal:__top__
{"count":66,"signals":[{"symbol":"SOLUSDT","score":8.22,...},...]}

# ティックデータのTTLを確認:
> TTL tick:binance:BTCUSDT
12

7.3 ボットコードでのRedis読み取り

MagicTradeBotは、Redis.Enabled: trueの場合、すべてのRedis読み取りを内部で処理します。ただし、カスタムスクリプトやダッシュボードでRedisから直接読み取ることもできます：

# Python
import redis, json

r = redis.Redis(host='127.0.0.1', port=6379)

# 価格を取得
tick = json.loads(r.get('tick:binance:BTCUSDT'))
price = tick['price']

# RSIを取得
signal = json.loads(r.get('signal:binance:BTCUSDT:30m'))
rsi = signal['rsi']

# トップアービトラージ機会を取得
top = json.loads(r.get('arb:signal:__top__'))
best = top['signals'][0]  # {'symbol': 'SOLUSDT', 'score': 8.22, 'spread': 1.42, ...}

// Rust — ArbEdgeBot統合
let price = get_last_price("binance", "BTCUSDT").await?.unwrap_or(0.0);
let signals: Vec<ArbSignal> = get_top_arb_signals().await?;
let funding_rates = get_all_funding_rates("bybit").await?;

// JavaScript / Node.js
const client = createClient({ url: 'redis://127.0.0.1:6379' });
const tick = JSON.parse(await client.get('tick:binance:BTCUSDT'));
const allPrices = JSON.parse(await client.get('tick:binance:__price__'));
// → { BTCUSDT: 67284.1, ETHUSDT: 3412.0, SOLUSDT: 184.2, ... 665シンボル }

8. デプロイメントパターン

8.1 パターン A — 単一ノード （初心者）

すべてを1台のマシンに。個人使用、テスト、または単一戦略ボットフリートに最適。

マシン: 1 VPS（4 CPU、8 GB RAM推奨）

┌─────────────────────────────────────────┐
│  RedisMarketBridge  (Engine: Both)       │  ← すべての取引所を並列同期
│  Redis 7.x                               │  ← 共有データストア
│  MagicTradeBot Bot 1                     │  ← Redisを読み取り、注文を配置
│  MagicTradeBot Bot 2                     │
│  MagicTradeBot Bot N                     │
└─────────────────────────────────────────┘

使用時期: 始めたばかりの場合、50未満のボットを実行している場合、または最大パフォーマンスよりもシンプルさが重要な場合。

8.2 パターン B — 分離されたブリッジ + ボット （推奨）

RedisMarketBridgeを取引所サーバーに近いデータノードに配置し、ボットを別の計算ノードに配置。

ノード A（データ — 取引所近くの低レイテンシVPS）:
  RedisMarketBridge  (Engine: MarketBridge)
  Redis 7.x

             ←→  （ネットワーク）  ←→

ノード B（計算 — ボットに適した場所）:
  MagicTradeBot Bot 1..N
  すべてノードAのRedisに接続

推奨ノード場所:

使用時期: 50以上のボットを実行している場合、またはティックデータのレイテンシが戦略にとって重要な場合。

8.3 パターン C — 分散 （上級）

取引所リージョンごとに1つのMarketBridgeノード、共有Redisクラスター、専用のSignalBridge計算ノード。

ノード1（東京）:         ノード2（シンガポール）:      ノード3（フランクフルト）:
  Engine: MarketBridge     Engine: MarketBridge      Engine: MarketBridge
  Exchange: binance         Exchange: bybit            Exchange: kraken, gateio

                ↓                  ↓                       ↓
          Redisクラスター （共有、リージョン間で複製）
                               ↓
ノード4（計算）:    SignalBridge — 全シンボルのRSI/MACD/CVD/OFIを計算
                               ↓
ノード5..N:           MagicTradeBotボットフリート — Redisを読み取り、注文を配置

📋 Studioライセンスが必要

パターンCには、最大5つの同時RedisMarketBridgeインスタンスを許可するStudioライセンス（月額79ドル）が必要です。各ノードは独立して実行されます — ノード障害はその取引所のデータにのみ影響し、フリート全体には影響しません。

9. シグナルエンジンの設定

すべてのシグナルはsettings/signal_engine.yamlで設定されます。Engine: SignalBridgeまたはEngine: Bothの場合にのみ適用されます。

9.1 利用可能なシグナル

9.2 設定例

# settings/signal_engine.yaml

rsi:
  enabled: true
  period: 14

macd:
  enabled: true
  fast_period: 12
  slow_period: 26
  signal_period: 9

atr:
  enabled: true
  period: 14

bollinger_bands:
  enabled: true
  bb_period: 20
  bb_deviation: 2.0

vwap:
  enabled: true
  std_dev_multiplier: 2.0

cumulative_volume_delta:
  enabled: true
  period: 10

order_flow_imbalance:
  enabled: true
  period: 5

# 高負荷 — CPUの低いマシンや高頻度ノードでは無効にしてください:
multi_timeframe_analysis:
  enabled: false
  short_term_period: 10
  medium_term_period: 30
  long_term_period: 50

ichimoku_cloud:
  enabled: false

9.3 パフォーマンスガイドライン

• 低CPUマシン / 1分インターバルノード: OFI、マルチタイムフレーム、一目均衡表を無効にする
• 専用SignalBridgeノード: すべて有効にする — MarketBridgeノードから計算をオフロードする
• 最小構成（最速）: RSI + MACD + ATRのみ — ほとんどのシグナルベースの戦略をカバー

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

10.1 Redisキーが空である / ボットが古いデータを報告する

# RedisMarketBridgeが実行中か確認:
ps aux | grep redis-market-bridge

# Redis接続を確認:
redis-cli ping   # → PONG

# キーが存在するか確認:
redis-cli KEYS 'tick:binance:*' | wc -l   # Binanceの場合は665であるべき

# TTLが健全か確認:
redis-cli TTL 'tick:binance:BTCUSDT'   # 1～15であるべき（-2 = 欠落、-1 = TTLなし）

キーがない場合は、application.yamlでDebugMode: trueを設定してRMBログを確認し、取引所接続エラーを確認してください。

10.2 Redisモードにもかかわらずボットがまだ取引所APIを呼び出している

1. MagicTradeBot設定でRedis.Enabled: trueを確認する
2. MagicTradeBotのRedis.HostとRedis.PortがRMBの書き込み先Redisインスタンスと一致することを確認する
3. FallbackWarningLog: trueを確認する — フォールバック警告が表示される場合、RMBは実行中だが特定のキーがないか期限切れである
4. 取引所名が正確に一致することを確認する（大文字小文字の区別："binance"は"Binance"ではない）

10.3 MEXCデータがないか一貫性がない

⚠️ MEXC既知の問題

MEXC先物APIは2022年から2026年までオフラインで、2026年3月に再開されました。安定化期間中はデータが信頼できない可能性があります。RMBログに[MEXC CAUTION]警告が表示される場合、これは予期される動作です。APIが安定するまでexchanges.yamlでMEXCを無効にすることを検討してください。

10.4 Redisモードにもかかわらずレート制限エラーが表示される

• 注文配置からのレート制限エラーは正常です — ボットは依然として直接注文を配置します。データ読み取りのみがRedisにオフロードされます。
• データ読み取りでレート制限が表示される場合、FallbackToDirectApiが繰り返しトリガーされたことを意味します。RMBが期待されるキーを書き込んでいない理由を確認してください。

10.5 KuCoin / Bitget / OKXのパスフレーズエラー

これらの取引所では、注文配置のためにボットの認証情報にパスフレーズが必要です。これはRedisやRedisMarketBridgeとは関係のないボット側のトレーディング要件です。各ボットの取引所認証情報セクションでパスフレーズを設定してください — これはRMBのexchanges.yaml認証情報（公開データ用にはオプション）とは別です。

10.6 ヘルスモニタリング

settings/notifications.yamlでDiscordまたはTelegramアラートを設定します：

Notifications:
  Discord:
    Enabled: true
    WebhookUrl: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
    AlertOn:
      - ExchangeDisconnect
      - RedisConnectionLost
      - HighLatencyWarning
      - MexcCaution

  Telegram:
    Enabled: false
    BotToken: ""
    ChatId: ""

11. Proへのアップグレード

無料（3取引所、1,751シンボル）とPro（12取引所、4,081以上のシンボル）のティアは同じバイナリを使用します。アップグレードは即時です — 再インストール不要、ライセンスキー以外の設定変更も不要です。

手順:

1. magictradebot.comでProライセンスを購入する
2. ライセンスキーをメールで受け取る
3. settings/license.yamlを開き、以下を設定します：

License:
  Key: "YOUR-LICENSE-KEY-HERE"

4. RedisMarketBridgeを再起動する
5. exchanges.yamlで追加の取引所のコメントを解除する
6. RedisMarketBridgeを再度再起動する — すべての12取引所ワーカーが起動します

Proでアクティブになる機能:

• ✅ OKX、Hyperliquid、Gate.io、KuCoin、Kraken、HTX、BingX、Phemex、MEXC
• ✅ 12の並列取引所ワーカー（各取引所は完全に独立）
• ✅ 4,081以上のUSDTパーペチュアルシンボル
• ✅ 66の取引所間アービトラージペア（無料ティアでは3）
• ✅ アービトラージシグナルスコア v2（スプレッド＋ファンディング＋流動性ウェイト）
• ✅ CVDおよびOFIシグナルのロック解除
• ✅ 全12取引所での完全なファンディングレートカバレッジ

12. クイックリファレンス

起動チェックリスト

• Redisが実行中でアクセス可能（redis-cli ping → PONG）
• RedisMarketBridgeが実行中でキーを書き込んでいる（redis-cli KEYS 'tick:*'）
• MagicTradeBotがRedis.Enabled: trueと正しいHost/Portを持っている
• ボットの取引所名がRMBのexchanges.yamlの取引所名と完全に一致する
• ボットAPIキーが注文配置用に設定されている（RMB認証情報とは別）
• 安全ネットとしてFallbackToDirectApi: trueが設定されている

主要コマンド

# Redisを起動
docker compose up -d redis

# RedisMarketBridgeを起動
./redis-market-bridge

# データが流れているか確認
redis-cli KEYS 'tick:binance:*' | wc -l    # → 665（Binance無料ティア）
redis-cli GET 'tick:binance:BTCUSDT'        # → {"price":...}
redis-cli GET 'arb:signal:__top__'          # → {"count":66,"signals":[...]}

# TTLが健全か確認（0より大きいはず）
redis-cli TTL 'tick:binance:BTCUSDT'        # → 1–15
redis-cli TTL 'signal:binance:BTCUSDT:30m'  # → 1–300

# RMB出力をリアルタイムで監視
redis-cli MONITOR

# Redis内の総キー数をカウント
redis-cli DBSIZE

取引所ティアの概要

サポート