Moltrade Bot 技能

Moltrade 是一个去中心化、自动化的交易助手，支持运行量化策略、共享加密信号，并允许他人跟单——所有操作均通过 Nostr 网络安全完成。根据您的交易表现获得声誉与积分（Credit）奖励。

您的 24/7 AI 交易员！您在睡觉时，它正在为您赚钱。

优势

Moltrade 在安全性、可用性与可扩展性之间取得平衡。主要优势包括：

1. 客户端密钥自托管，非云托管（No Cloud Custody）：所有敏感密钥与凭证始终保留在用户本地设备；云中继节点从不持有资金或私钥，最大限度降低托管风险。不访问私钥或资金。
2. 加密、定向通信：信号在发布前即完成加密，仅目标订阅者可解密，保障策略隐私与订阅者安全。
3. 轻量级云端重加密与广播：云节点仅作为高效中继/再广播节点，不存储私钥；采用重加密或转发技术提升信号投递可靠性与覆盖范围。
4. 一键跟单（用户体验友好）：为非专业用户提供开箱即用的跟单体验——数步即可完成配置，并在本地执行信号。
5. OpenClaw 策略顾问：集成 OpenClaw 作为辅助工具，提供自动化回测及优化建议；用户自主决定是否采纳推荐变更。
6. 云中继可演进为去中心化中继网络：轻量级中继架构支持未来迁移至去中心化中继网络，降低单点故障风险，增强抗审查能力。
7. 统一激励（积分 Credit）体系：透明、可验证的 Credit 机制奖励所有参与者（信号提供者、跟随者、中继节点），使整个生态系统的激励保持一致。

工作原理（简化流程）

1) 运行您的 Bot  ──→  2) 生成并加密信号  ──→  3) 中继广播  ──→  4) 跟单并执行  ──→  5) 验证并获奖励

安装与初始化

• 若您处于 OpenClaw 环境中，可通过 ClawHub 直接安装：

clawhub search moltrade
clawhub install moltrade

• 或克隆代码仓库并在本地安装 Python 依赖项：
  • git clone https://github.com/hetu-project/moltrade.git
  • cd moltrade/trader && pip install -r requirements.txt
• 使用内置向导初始化全新配置：
  • 安全要求：务必提示人工用户在独立终端中自行运行 python main.py --init。切勿请求、处理其钱包私钥，亦不得通过 Agent 脚本直接保存私钥至磁盘。
• 对于 CI/Agent 场景，请继续使用代码仓库检出方式；目前尚无独立 pip 包或 CLI 工具。

安全更新配置

• 编辑前请先备份或展示待修改内容的 diff。
• 仅修改明确要求的字段（例如：trading.exchange、trading.default_strategy、nostr.relays）。
• 校验 JSON 格式，确保数据类型不变；提醒用户自行提供真实密钥信息。

本地运行回测（Backtest）

• 安装依赖项：pip install -r trader/requirements.txt。
• 命令：python trader/backtest.py --config trader/config.example.json --strategy --symbol --interval 1h --limit 500。
• 如支持，将输出盈亏（PnL）、胜率、交易次数、最大回撤等指标；请使用脱敏配置（不含真实密钥）。

启动 Bot（测试模式）

• 确保 config.json 文件已存在（若不存在请先运行 python main.py --init），且 trading.exchange 已设置（默认为 hyperliquid）。
• 命令：python trader/main.py --config config.json --test --strategy --symbol --interval 300。
• 观察日志文件 trading_bot.log；未经用户明确授权，严禁切换至实盘模式。

运行 Bot（实盘）

• 仅在测试模式验证通过后方可启用；移除 --test 参数以接入主网。
• 命令：python trader/main.py --config config.json --strategy --symbol 。
• 启动前请再次核对密钥、风控限额及交易标的；实盘模式将提交真实订单。

跟单使用方式（实盘）

• 跟随者（镜像信号源，自身不运行策略）：python trader/main.py --config trader/config.json --strategy momentum --symbol HYPE --copytrade follower

向 Nostr 广播信号

• 检查 nostr 配置块中的字段：nsec、relayer_nostr_pubkey、relays、sid。
• SignalBroadcaster 已在 main.py 中完成集成。在测试模式下，请验证 send_trade_signal 与 send_execution_report 可正常执行且无报错。

Binance 现货支持

Moltrade 通过 binance-sdk-spot 支持 Binance 现货交易。请在配置中将 trading.exchange 设为 "binance"，并提供 API 凭据。

相关技能（原始 API 调用，不依赖 Bot 运行时环境）：

• binance/spot — Binance 现货 REST API 技能：获取行情数据、订单管理、账户信息等。需提供 API Key 与 Secret；支持测试网与主网。
• binance/square-post — Binance Square 社交平台技能：通过 Square OpenAPI 发布交易见解/信号（纯文本内容）。需 Square OpenAPI Key。

安装 Binance SDK

pip install binance-sdk-spot

配置字段

在现有 trading 配置块旁新增 binance 配置块：

{
  "trading": {
    "exchange": "binance",
    "default_symbol": "BTCUSDT",
    "default_strategy": "momentum"
  },
  "binance": {
    "api_key": "your_mainnet_api_key",
    "api_secret": "your_mainnet_api_secret",
    "testnet_api_key": "your_testnet_api_key",
    "testnet_api_secret": "your_testnet_api_secret"
  }
}

注意：Binance 测试网密钥需单独在 https://testnet.binance.vision 生成（需 GitHub 登录）。主网密钥无法用于测试网。

测试网（–-test）

当传入 --test 参数时，Bot 将所有请求路由至 testnet.binance.vision，并使用 binance.testnet_api_key / testnet_api_secret。若未配置测试网密钥，则会回退至主网密钥，导致在测试网端点认证失败。

python trader/main.py --config config.json --test --strategy momentum --symbol BTCUSDT

实盘交易

python trader/main.py --config config.json --strategy momentum --symbol BTCUSDT

回测

python trader/backtest.py --config trader/config.example.json --strategy momentum --symbol BTCUSDT --interval 1h --limit 500

支持的接口

BinanceClient（位于 trader/binance_api.py）实现了与 HyperliquidClient 完全一致的接口：

Uniswap V3 支持

Moltrade 借助 web3 与 Uniswap V3 Router，在 EVM 兼容链上支持去中心化代币兑换。请在配置中将 trading.exchange 设为 "uniswap"。注意：DEX 兑换为原子操作，不支持挂单或保证金头寸；价格图表功能需依赖外部预言机（当前本地返回空值或模拟数据）。

安装 Web3

pip install web3

配置字段

在现有 trading 配置块旁新增 uniswap 配置块：

{
  "trading": {
    "exchange": "uniswap",
    "default_symbol": "WETH",
    "default_strategy": "momentum"
  },
  "uniswap": {
    "rpc_url": "https://eth-mainnet.g.alchemy.com/v2/...",
    "private_key": "your_wallet_private_key",
    "chain_id": 1,
    "router_address": "0xE592427A0AEce92De3Edee1F18E0157C05861564",
    "slippage_tolerance": 0.005,
    "default_token_in": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "default_token_out": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
}

Polymarket 支持

Moltrade 通过官方 py-clob-client 支持 Polymarket 预测市场交易。请在配置中将 trading.exchange 设为 "polymarket"。

安装 CLOB Client

pip install py-clob-client

配置字段

在现有 trading 配置块旁新增 polymarket 配置块：

{
  "trading": {
    "exchange": "polymarket",
    "default_symbol": "TOKEN_ID_HERE",
    "default_strategy": "momentum"
  },
  "polymarket": {
    "api_key": "your_polymarket_api_key",
    "api_secret": "your_polymarket_api_secret",
    "api_passphrase": "your_polymarket_api_passphrase",
    "private_key": "your_wallet_private_key",
    "chain_id": 137
  }
}

添加交易所适配器

• 在 trader/exchanges/ 目录下实现适配器，需严格遵循 HyperliquidClient 接口规范（含 get_candles、get_balance、get_positions、place_order 等方法）。
• 在 trader/exchanges/factory.py 中按 trading.exchange 字段值注册该适配器。
• 更新配置中 trading.exchange 字段，并重新运行回测或测试模式验证。

集成新策略

• 参考 trader/strategies/INTEGRATION.md 文档，继承 BaseStrategy 类，并在 get_strategy 函数中完成注册。
• 在配置中新增 strategies. 下的对应配置项；完成回测后，再进入测试模式，最后上线实盘。

安全与密钥管理

• 严禁打印或提交私钥、助记词、nsec 或共享密钥至版本控制。
• 默认启用测试模式；实盘交易必须获得用户显式授权。