安装指南

前置条件

• Docker Desktop（仅在使用 Redis 时需要）
• 一个受支持的交易所账户及 API 密钥
• 服务器的公网 IP 地址（用于 API 白名单）

目录

1. 机器人配置
2. API 密钥设置
3. Redis 设置
4. RedisMarketBridge
5. 运行机器人
6. 故障排查
7. TradingView 集成

1. 机器人配置

所有配置均通过在线配置器完成。

1. 打开：配置器
2. 选择 MagicTradeBot
3. 进行配置：

导出设置：

1. 点击 Export All YAML
2. 解压文件
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

重要说明

• 确保交易对与机器人配置完全一致
• 使用正确的时间周期对齐
• 先用小额交易测试

⚠️ 错误的 payload 格式 = 信号将被忽略

测试

可使用以下方式模拟 webhook：

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

✅ 如果配置正确，机器人将执行交易

💡 详细信息请参考 TradingView 官方集成文档。