MagicTradeBot v6.0 — RedisMarketBridge 集成指南

实时市场数据。每个 bot 零 API 调用。无限速风险。

产品 MagicTradeBot v6.0 模块 RedisMarketBridge 集成 层级 免费（3个交易所）· Pro（12个交易所） 支持 discord.gg/magictradebot · support@magictradebot.com

---

目录

1. 简介
2. 架构概览
3. 前提条件
4. 安装 & 设置
5. 在 MagicTradeBot 中启用 Redis
6. 运行多个 Bot
7. Redis 键模式
8. 部署模式
9. 信号引擎配置
10. 故障排除
11. 升级到 Pro
12. 快速参考

1. 简介

MagicTradeBot v6.0 引入了原生 Redis 集成，支持一种全新的架构来同时运行多个 bot。通过连接到 RedisMarketBridge 作为共享市场数据层，您集群中的每个 bot 都从 Redis 读取实时市场数据，而不是直接调用交易所 API——无论有多少个 bot 在运行。

为何重要

没有 Redis： 币安上 10 个 bot = 10 倍的速率限制消耗。100 个 bot = 几乎必然被限流。

使用 Redis： 币安上 1,000 个 bot = 与 RedisMarketBridge 使用相同的 1 个速率限制槽。您的 bot 对交易所不可见。

RedisMarketBridge 是唯一的事实来源。所有 bot 都以微秒级的速度从中消费数据——无需网络往返，每个 bot 无需 API 密钥。

1.1 什么是 RedisMarketBridge？

RedisMarketBridge 是一个自托管的开源（MIT）市场数据管道，它能够：

• 使用每个交易所专用的并行工作线程，同时连接到最多 12 个交易所
• 获取并标准化市场数据：ticker、K线、资金费率、订单簿变动、跨交易所价差
• 通过 6 阶段管道处理数据——从原始 tick 到结构化的、带 TTL 管理的信号
• 使用任何语言都能读取的一致键模式将所有内容写入 Redis
• 计算信号——RSI、MACD、布林带、VWAP、CVD、OFI——并将其与原始数据一起存储

1.2 MagicTradeBot v6.0 如何使用它

当在 MagicTradeBot 中启用 Redis 模式时，每个 bot 实例都会改变其数据获取策略：

交易逻辑、信号处理、订单下单和风险管理没有变化。只有数据摄取层发生了变化——而性能差异是巨大的。

2. 架构概览

2.1 完整技术栈

币安 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          │  所有 bot 从 Redis 读取
                          │  MagicTradeBot Bot 3          │  零直接交易所调用
                          │  MagicTradeBot Bot N  (∞)     │
                          └──────────────────────────────┘

所有 bot 都从 Redis 读取。bot 代码中零直接交易所 API 调用。交易所只与 RedisMarketBridge 通信。

2.2 6 阶段管道

RedisMarketBridge 在市场数据到达您的 bot 之前，通过六个顺序阶段对其进行处理：

3. 前提条件

3.1 所需软件

3.2 交易所 API 密钥

RedisMarketBridge 仅使用公共端点获取市场数据——ticker、K线或资金费率不需要 API 密钥。API 密钥是可选的，仅在以下情况需要：

• 在某些交易所（币安、OKX）获得更高的速率限制
• 访问私有数据（在市场数据管道中未使用）
• 启用后的未来交易功能

⚠️ 重要 — Bot API 密钥

MagicTradeBot 仍然需要交易所 API 密钥用于下单。只有市场数据摄取被卸载到 RedisMarketBridge。您的 bot 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 许可证后，下载适用于您操作系统的预构建二进制文件。无需构建步骤。相同的二进制文件适用于免费功能——您的许可证密钥会立即激活 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          # 如果 bot 数量多，请增加

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] Tick 数据流 — 周期 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               # 每个 bot 实例的连接池大小

  # Redis 不可用时的回退行为：
  FallbackToDirectApi: true        # 如果 Redis 键缺失，回退到直接 API 调用
  FallbackWarningLog: true         # 每次回退时记录警告日志
  FallbackStaleThresholdMs: 30000  # 如果数据超过 30 秒，视为过时

5.2 启用 Redis 后的变化

✅ 回退保护

如果 Redis 键缺失或过期（例如 RedisMarketBridge 宕机），MagicTradeBot 会自动回退到针对该特定数据点的直接交易所 API 调用。这确保了 bot 不会因数据层故障而停止运行。设置 FallbackToDirectApi: false 可禁用（生产环境不推荐）。

6. 运行多个 Bot

6.1 核心优势

6.2 单交易所 — 多个 Bot

运行 20 个不同的策略 bot，全部针对币安 USDT 永续合约：

# bot-1-btc.yaml  （做多/做空 BTC，15m 信号）
Exchange: "binance"
Symbol: "BTCUSDT"
Strategy: "momentum"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# bot-2-eth.yaml  （做多/做空 ETH，30m 信号）
Exchange: "binance"
Symbol: "ETHUSDT"
Strategy: "mean_reversion"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# ... 根据需要重复任意数量的 bot
# 所有 bot 从同一个 Redis 读取 — 币安只看到 RMB 的单个连接

6.3 多交易所 — 多个 Bot

同时在 5 个不同的交易所运行 bot。没有 Redis 的话，这需要跨所有 bot 管理 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       # 从 Redis 读取预计算的 arb:signal:SOLUSDT 信号

💡 跨交易所套利 Bot

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,...},...]}

# 检查 tick 数据的 TTL：
> TTL tick:binance:BTCUSDT
12

7.3 在 Bot 代码中从 Redis 读取

当 Redis.Enabled: true 时，MagicTradeBot 会内部处理所有 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 — 单节点 （初学者）

所有组件都在一台机器上。最适合个人使用、测试或单策略 bot 集群。

机器：1 台 VPS（推荐 4 CPU，8 GB RAM）

┌─────────────────────────────────────────┐
│  RedisMarketBridge  (Engine: Both)       │  ← 并行同步所有交易所
│  Redis 7.x                               │  ← 共享数据存储
│  MagicTradeBot Bot 1                     │  ← 读取 Redis，下单
│  MagicTradeBot Bot 2                     │
│  MagicTradeBot Bot N                     │
└─────────────────────────────────────────┘

使用时机： 刚起步时，运行少于 50 个 bot，或者简单性比最高性能更重要时。

8.2 模式 B — 分离的桥接器 + Bot （推荐）

将 RedisMarketBridge 放在靠近交易所服务器的数据节点上，将 bot 放在单独的计算节点上。

节点 A（数据 — 靠近交易所的低延迟 VPS）：
  RedisMarketBridge  (Engine: MarketBridge)
  Redis 7.x

             ←→  （网络）  ←→

节点 B（计算 — 适合您 bot 的任何地方）：
  MagicTradeBot Bot 1..N
  全部连接到节点 A 的 Redis

推荐节点位置：

使用时机： 运行 50 个以上 bot，或者当 tick 数据延迟对您的策略很重要时。

8.3 模式 C — 分布式 （高级）

每个交易所区域一个 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 bot 集群 — 读取 Redis，下单

📋 需要 Studio 许可证

模式 C 需要 Studio 许可证（每月 79 美元），该许可证允许最多 5 个并发 RedisMarketBridge 实例。每个节点独立运行 — 一个节点故障只会影响该交易所的数据，而不会影响整个集群。

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 键为空 / Bot 报告数据过时

# 检查 RedisMarketBridge 是否正在运行：
ps aux | grep redis-market-bridge

# 检查 Redis 连接：
redis-cli ping   # → PONG

# 检查键是否存在：
redis-cli KEYS 'tick:binance:*' | wc -l   # 币安应有 665 个

# 检查 TTL 是否健康：
redis-cli TTL 'tick:binance:BTCUSDT'   # 应该在 1–15 之间（不是 -2 = 缺失，不是 -1 = 无 TTL）

如果键缺失，请在 application.yaml 中将 DebugMode: true 设置为检查 RMB 日志，以查看交易所连接错误。

10.2 尽管处于 Redis 模式，Bot 仍然命中交易所 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 模式仍出现速率限制错误

• 下单时的速率限制错误是正常的 — bot 仍然直接下单。只有数据读取被卸载到 Redis。
• 如果在数据读取时看到速率限制，则意味着 FallbackToDirectApi 被重复触发。请检查 RMB 为何没有写入预期的键。

10.5 KuCoin / Bitget / OKX 密码短语错误

这些交易所需要在下单时在 bot 凭证中提供密码短语。这是一个与 Redis 或 RedisMarketBridge 无关的 bot 端交易要求。请在每个 bot 的交易所凭证部分设置密码短语 — 它与 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
• Bot 的交易所名称与 RMB 的 exchanges.yaml 中的交易所名称完全匹配
• 已为下单设置 Bot API 密钥（与 RMB 凭证分开）
• 设置 FallbackToDirectApi: true 作为安全网

关键命令

# 启动 Redis
docker compose up -d redis

# 启动 RedisMarketBridge
./redis-market-bridge

# 验证数据是否在流动
redis-cli KEYS 'tick:binance:*' | wc -l    # → 665（币安免费层级）
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

交易所层级摘要

支持