# quant-standard

**Repository Path**: jorking/quant-standard

## Basic Information

- **Project Name**: quant-standard
- **Description**: 通用量化交易系统，解决个人量化交易，通用处理系统，本框架 支持期货， 外汇，现货，数字货币，美股，A股，实现个人无界交易通路，不用再为了各个平台规则不同，苦恼，一个通用交易系统平台，商务合作联系：783508887@qq.com， 18200198224 v信 。quant-standard-sample v1.0.0：数据有效性、撮合方向、账务不变量与可复现性。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# quant-standard-sample

JDK 1.8 下可运行的最小量化交易标准样板系统（A 股宽基 ETF 本地化版）。

## 运行

方式一（推荐，需 Maven）：
    mvn clean package
    java -jar target/quant-standard-sample.jar

方式二（仅需 JDK 8）：
    Linux/Mac:  ./run-selfcheck.sh
    Windows:    run-selfcheck.bat

## 自检覆盖

- L1 数据校验：OHLC/价格有效性、时间戳严格递增
- L1b K 线校验：OHLC 自洽、成交量非负、时间戳严格递增
- L2 执行审计：成交笔数 > 0（防零成交假通过）、整手成交、佣金 ≥ 最低 5 元、限价成交方向
- L3 账务不变量：现金非负、持仓非负、今日买入 ≤ 持仓、权益有限
- L5 可复现性：同数据同参数两次回测结果一致（三段策略各自断言）

## 策略自检（三段，共用同一引擎/风控/撮合链路）

- [动量轮动] ETFMomentumRotationAlgo：宽基 ETF 原始动量轮动（含完整在途单管理）
- [风险调整] ETFMomentumRotationAlgo riskAdjusted 模式：动量/波动率排序
- [均值回归] BBandsMeanReversionAlgo：布林带下轨买入、中轨卖出（震荡行情，成交 22 笔）

## A 股 ETF 能力（v1.2）

- instrument.TradingRule：整手 100 份、佣金 max(5 元, 万 2.5)、连续竞价时段、日键
- instrument.ETFUniverse：12 只宽基 ETF 池元数据（涨跌幅限制、参考价）
- gateway.ASHareExecutionModel：涨停不买/跌停不卖、成交价夹涨跌停区间取整到 0.01 元
- 风控规则链：整手/零股、涨跌停限价、T+1、资金可用性、持仓上限、单笔金额上限
- 日切机制：Account.settleDay（昨收滚动 + T+1 冻结清理）+ AlgoTemplate.onNewDay

## 工具

- util.IndicatorUtil：SMA、样本标准差、最大回撤（通用指标）
- util.MonthlyPatternUtil：月线箱体突破、W 底、头肩底、月均线多/空头

## 两种回测驱动

- engine.run(ticks)：Tick 级回测，撮合精度最高（多标的需按时间戳全局升序，引擎强制校验）
- engine.runBars(dailyBars)：日 K 驱动，引擎自动聚合月 K 并分发 onMonthlyBar，供超长线策略使用

## 扩展

- 替换行情源：实现 Tick 列表加载器，接入 CSV/WebSocket（多标的按时间戳全局升序）
- 替换网关：实现 AlgoTemplate.OrderGatewayRef，接入券商 SDK
- 框架级资金/持仓冻结：在 SimulatedGateway 实现挂单冻结额度
- 拆分多模块：将 event/data/strategy/gateway/risk/engine/instrument/util 拆为独立 Maven 模块

## 文档

完整项目文档见 `docs/PROJECT.md`；扩展归档见 `docs/ASHARE-EXTENSION.md`（v1.2）与 `docs/MONTHLY-EXTENSION.md`（v1.1）。