OpenTrader 是一款自托管的加密货币交易机器人，内置多种高度可定制的策略，支持技术指标集成、高频交易以及跨交易所交易，并通过 CCXT 支持超过 100 家交易所。

功能：

• ✨ 强大的用户界面：提供友好的界面用于管理交易机器人。
• 🌐 多个交易所：可在多个加密货币交易所进行交易。
• 📝 纸上交易：在不冒真实资金风险的情况下测试您的策略。
• 📊 回测：使用历史数据回测您的策略。
• ⚙️ 轻松安装：通过 NPM 即可轻松安装。

策略：

• ☑️ 网格交易：通过设置买入和卖出订单的网格来从市场波动中获利。
• ☑️ 定投策略：通过多次下单平均入场成本，并在价格波动时卖出。
• ☑️ RSI 指标交易：根据 RSI 指标值下达订单。
• 🛠️ 自定义策略：只需几行代码即可构建您自己的策略。

💓 项目状态

本项目是我利用业余时间开发的个人爱好。如果您觉得它有用，请给它一个 ⭐️。您的支持对我意义重大，也激励我不断改进这款机器人。如果您愿意捐赠捐款，请参阅下方选项。💖

🍩 捐款

如果您觉得 OpenTrader 有用并希望支持其开发，不妨考虑捐赠。您的捐助将帮助我们支付维护和改进该项目的费用。

捐赠方式：

• 比特币 (BTC)：1LBqWWne1ac455UmUDVF32ozVAhy1HgVXn
• 以太坊 (ETH)：0x60371d49F9Cc7ec7d7e34979D5DD31996B7B43Ff

感谢您的支持！

👋🏻 加入我们的社区

👥 与开发者交流、提出功能需求并获得支持。欢迎加入我们在 Discord 的社区。

🔔 如需获取公告和最新动态，请关注我们的 Twitter 和 Telegram。

⚡️ 快速入门

只需几个步骤即可开始使用 OpenTrader。按照本快速指南安装、配置并运行您的加密货币交易机器人。

[!NOTE] OpenTrader 需要 Node.js v22 或更高版本。您可以通过运行 node -v 来检查您的 Node.js 版本。

安装

1. 使用 npm 全局安装 OpenTrader：

npm install -g opentrader

2. 设置管理员密码以便后续访问 OpenTrader UI：

opentrader set-password <password>

3. 启动 OpenTrader 应用程序

opentrader up

应用程序将启动 RPC 服务器并监听 8000 端口。

提示：使用 opentrader up -d 将应用作为守护进程启动。要停止它，运行 opentrader down。

使用方法

UI

用户界面允许管理多个交易机器人和策略、查看回测结果以及监控实时交易。

您可以在以下地址访问 OpenTrader UI：http://localhost:8000

CLI

连接交易所

将 exchanges.sample.json5 文件复制到 exchanges.json5 并添加您的 API 密钥。

可用交易所：OKX、BYBIT、BINANCE、KRAKEN、COINBASE、GATEIO、BITGET

选择策略

创建策略配置文件 config.json5。我们将以“网格交易”策略为例。

{
  // 网格交易参数
  settings: {
    highPrice: 70000, // 网格的最高价
    lowPrice: 60000, // 网格的最低价
    gridLevels: 20, // 网格层级数量
    quantityPerGrid: 0.0001, // 每个网格对应的基准货币数量
  },
  pair: "BTC/USDT",
  exchange: "DEFAULT",
}

目前支持的策略：grid、dca、rsi

运行回测

命令：opentrader backtest <strategy> --from <date> --to <date> -t <timeframe>

例如，在 1h 时间框架下运行“网格交易”策略。

opentrader backtest grid --from 2024-03-01 --to 2024-06-01 -t 1h

为了获得更准确的结果，可以使用更小的时间框架，例如 1m，但这样会花费更多时间从交易所下载 OHLC 数据。

实时交易

命令：opentrader trade <strategy>

例如，使用“网格交易”策略进行实时交易。

opentrader trade grid

要停止实时交易，运行 opentrader stop。

项目结构

• 策略目录：packages/bot-templates
• 指标：packages/indicators
• 交易所连接器：packages/exchanges

🪪 许可证

根据 Apache 2.0 许可证授权。更多信息请参阅 LICENSE 文件。

免责声明

本软件仅用于教育目的。请自行承担使用本软件的风险。作者及其所有关联方对您的交易结果不承担任何责任。请勿拿您害怕失去的资金进行交易。代码中可能存在漏洞——本软件不提供任何担保。

OpenTrader 快速上手指南

环境准备

• 系统要求：Linux / macOS / Windows（WSL2 推荐）
• Node.js：≥ v22（node -v 查看版本）
• 网络：可访问 GitHub 与 npm

安装步骤

# 1. 全局安装
npm install -g opentrader

# 2. 设置管理员密码（用于登录 Web UI）
opentrader set-password <你的密码>

# 3. 启动服务
opentrader up
# 后台运行
opentrader up -d

启动后浏览器访问 http://localhost:8000 即可进入管理界面。

基本使用

1. 连接交易所

# 复制示例配置
cp exchanges.sample.json5 exchanges.json5
# 编辑 exchanges.json5，填入 API Key / Secret

支持：OKX、Binance、Bybit、Kraken、Coinbase、Gate.io、Bitget 等。

2. 创建策略配置

新建 config.json5，以网格策略为例：

{
  settings: {
    highPrice: 70000,
    lowPrice: 60000,
    gridLevels: 20,
    quantityPerGrid: 0.0001
  },
  pair: "BTC/USDT",
  exchange: "DEFAULT"
}

3. 回测

# 2024-03-01 至 2024-06-01，1h K 线
opentrader backtest grid --from 2024-03-01 --to 2024-06-01 -t 1h

4. 实盘交易

# 启动网格策略实盘
opentrader trade grid
# 停止
opentrader stop

至此，你已能运行并管理自己的加密货币量化交易机器人。