Paper Trader

运行结构化模拟交易循环,使用SQLite进行事件日志记录、仓位跟踪和盈亏审查。用于开仓/平仓模拟交易及记录。

安装

概览

Paper Trader 是一款基于 SQLite 的模拟交易工具,专为交易者在投入真实资金前验证策略而设计。它通过不可变的事件日志记录所有市场快照、开仓平仓操作以及仓位调整,确保交易历史的完整性与可追溯性。该工具支持多账户管理,允许用户为不同策略或风险偏好创建独立的模拟账户,并通过统一的数据库进行集中跟踪。核心功能包括实时盈亏计算、头寸状态查询和周期性复盘报告生成,帮助交易者系统化地评估策略表现。由于采用 Node.js 原生模块 `node:sqlite`,无需额外依赖即可运行,极大降低了使用门槛。无论是加密货币还是传统资产,只要能提供符号(symbol)和铸造地址(mint),均可纳入模拟交易体系。

核心功能特点

  1. 基于 SQLite 构建,提供持久化且不可篡改的交易事件日志
  2. 支持多账户管理,每个账户可独立设置基础货币与初始余额
  3. 自动计算已实现与未实现盈亏,结合最新市场快照动态更新 PnL
  4. 完整的交易生命周期管理:从开仓、止损止盈调整到分批平仓
  5. 内置命令支持市场快照记录、仓位状态查看与每周复盘分析
  6. 无需 npm 安装依赖,直接使用 Node.js 原生 SQLite 模块运行

适用场景

Paper Trader 特别适合那些希望在投入真金白银前先验证交易想法的投资者和量化分析师。例如,一个加密货币交易者在发现某 DEX 上 BTC/USDT 出现突破信号时,可以使用该工具建立模拟仓位,并设定明确的止损和止盈点位,同时记录其交易逻辑与市场假设。随着价格波动,他可以随时调整保护性止损或滚动止盈,系统会自动重新计算当前浮亏浮盈。另一个典型场景是机构交易员需要定期进行策略回测前的模拟演练,此时可通过每周执行一次 review 命令,导出 JSON 格式的历史事件流,用于后续分析与模型优化。此外,对于希望建立个人交易日志体系的散户而言,每次操作后添加备注并打标签(如 ‘thesis’、’risk’),有助于长期积累认知与纪律训练。整个流程强调‘只增不改’原则——所有历史事件均不可修改,保证数据真实性,从而让复盘结论更具参考价值。