1. 项目定位与用途
EasyTradingEngine 是一个专为 OKX 交易所设计的开源量化交易系统，采用 Node.js 开发。系统定位为专业级交易平台，提供多种内置交易策略（网格交易、对冲交易、做市商策略），并支持实时行情数据处理、技术指标计算、可视化图表展示以及全面的风险控制功能。用户可通过该系统自动化执行交易策略，实时监控持仓盈亏，并通过可视化看板分析策略表现，显著降低自行开发交易系统的技术门槛与时间成本。
项目档案应用项目
MRchenkuan/EasyTradingEngine 是什么？用途、安装与使用指南
EasyTradingEngine 是基于 Node.js 的 OKX 交易所量化交易系统，提供网格交易、对冲交易等多种策略，支持实时行情处理、可视化图表和风险控制。本页详细介绍项目功能、安装配置步骤及使用方式。
AI 总结
EasyTradingEngine 是一个基于 Node.js 的专业量化交易系统，专为 OKX 交易所设计，支持网格交易、对冲交易、做市商等多种策略，提供实时行情处理、可视化图表和风险控制功能，帮助交易者自动化执行策略并降低开发门槛。
中文项目介绍
EasyTradingEngine 是一个专为 OKX 加密货币交易所设计的开源量化交易系统，采用 Node.js 构建。系统核心功能包括多策略支持（网格交易、对冲交易、做市商策略）、实时 WebSocket 行情数据处理、内置图表可视化引擎、以及多层风险控制机制（如持仓警戒、止损和保证金管理）。
该系统旨在解决加密货币交易者自行开发交易系统的技术门槛高、开发周期长的问题。通过提供开箱即用的策略处理器、统一的风险管理框架和实时监控看板，用户无需从零搭建即可快速部署自动化交易策略，同时通过可视化工具直观分析策略表现和盈亏情况。
适用于需要在 OKX 交易所进行自动化交易的个人或团队，特别是希望执行网格交易捕捉波动收益、通过多空对冲实现套利、或运行做市商策略获取价差的用户。也适合作为量化交易学习与研究平台，因其模块化设计便于扩展新策略。
基于仓库信息，系统采用模块化架构，核心 TradeEngine 协调各组件；策略均继承 AbstractProcessor 并实现 tick 方法确保接口统一；图表渲染通过 Web Worker 分离至独立线程以提升性能；依赖 ws 库处理 WebSocket 连接，使用 chartjs-node-canvas 生成图表；提供完整的 npm 脚本、Docker 部署方案及 pm2 进程管理支持。
详细信息与使用说明
2. 解决的问题
量化交易者常面临自行开发交易系统复杂度高、周期长的问题。EasyTradingEngine 解决了以下痛点：一是提供开箱即用的策略处理器，避免从零实现交易逻辑；二是统一的风险管理框架，通过多层止损、持仓监控和保证金管理降低交易风险；三是实时可视化看板，直观展示策略盈亏、持仓分布等关键信息；四是模块化架构设计，便于用户根据需求扩展新策略或调整现有策略参数，提升系统灵活性。
3. 适用场景
该系统主要适用于 OKX 交易所的用户，包括个人交易者和量化团队。典型场景包括：执行网格交易策略，在价格波动中通过低买高卖获取收益；运行对冲交易策略，同时持有相关资产的多空头寸以捕捉价差变化；部署做市商策略，提供流动性并赚取买卖价差；作为量化交易学习平台，研究策略逻辑、风险控制和实时数据处理技术。此外，系统支持模拟盘与实盘环境，适合策略回测与实盘过渡。
4. 安装方式
根据仓库 README，安装过程分为三步：首先，运行 npm install 或 pnpm install 安装项目依赖，包括 ws、axios、canvas、chartjs-node-canvas 等核心库；其次，根据交易环境创建配置文件：实盘需创建 config.security.js，模拟盘创建 config.security.mimic.js，两者均需填入 OKX API Key、Secret 和 Passphrase；最后，编辑 config.js 文件，设置交易环境（生产或模拟）、K线周期、历史数据天数等参数，并配置具体策略的资产、金额、网格宽度等变量。所有步骤均有明确文件与示例，未涉及额外系统依赖。
5. 使用方式
系统提供丰富的 npm 脚本命令：npm run start 启动主交易程序，持续运行策略；npm run trading 启动手动交易界面；npm run open <币种> <金额> 开仓（支持 sol、eth 等简写）；npm run close <仓位ID> 平仓；npm run list 查看当前持仓，npm run monit 监控持仓状态；npm run graph 生成可视化图表。此外，支持 Docker 容器化部署（docker:build、docker:run 等）和 pm2 进程管理（pm2:start、pm2:logs 等），满足不同部署需求。
6. 实现特点
系统实现上具有多个显著特点：模块化架构，核心 TradeEngine 协调策略处理器、可视化引擎和 API 接口，各组件解耦便于维护；策略抽象层，所有策略继承 AbstractProcessor 并实现 tick 方法，保证统一接口与扩展性；性能隔离，图表渲染通过 VisualWorker 在独立线程执行，避免阻塞交易主线程；实时数据流，基于 WebSocket 接收 OKX 行情，结合技术指标库进行实时计算；多层风控，内置持仓警戒线、止损线及保证金监控逻辑；此外，提供完整 Docker 支持与 pm2 集成，简化部署与运维。
思维导图
EasyTradingEngine 项目结构
核心模块
TradeEngine.js
VisualEngine.js
VisualWorkerManager.js
策略处理器
GridTradingProcessor
HedgeProcessor
MarketMakerProcessor
TrendFollowingProcessor
图表绘制
MainGraph
GridTradingSlice
HedgeProfitDistance
HedgeTransactionSlice
技术指标
MA
BOLL
RSI
ATR
CD
IV
RSD
命令行工具
open.js
close.js
positions.js
grid.js
graph.js
help.js
Worker 线程
VisualWorker
配置文件
config.js
config.security.js
config.security.mimic.js
常见问题
如何安装 EasyTradingEngine？
运行 npm install 或 pnpm install 安装依赖；根据环境创建 config.security.js（实盘）或 config.security.mimic.js（模拟盘），填入 OKX API 密钥；编辑 config.js 配置交易环境与策略参数。
如何启动交易程序并进行操作？
使用 npm run start 启动主程序；npm run open <币种> <金额> 开仓（如 sol eth 2000）；npm run close <仓位ID> 平仓；npm run list 查看持仓，npm run monit 监控持仓。
系统支持哪些交易策略？
内置网格交易、对冲交易、做市商策略，所有策略均继承 AbstractProcessor 并实现 tick 方法，用户可基于该抽象类扩展自定义策略。
是否支持 Docker 部署？
是，项目提供完整的 Docker 脚本链，包括 docker:build、docker:run、docker:logs、docker:stop 等，支持容器化部署与远程镜像传输。
如何生成可视化图表？
执行 npm run graph 命令可生成各类可视化图表，系统通过 painters 模块基于 chartjs-node-canvas 绘制实时看板、利润曲线等技术指标图表，图表渲染在独立 Worker 线程中执行。