Skip to content
JH_QUANT JH_QUANT 文档

安装与概览

jh_quant 是量化交易研究与执行平台，覆盖数据获取、回测、因子计算、模拟盘、实盘执行、组合优化和可视化 Dashboard。

环境要求

  • Python 3.10+
  • 推荐使用 uv 或虚拟环境管理项目依赖

安装

Terminal window
pip install jh_quant

配置 API Key

Terminal window
set JIUHUANG_API_KEY=your-api-key

也可以使用 .env：

JIUHUANG_API_KEY=your-api-key
JIUHUANG_API_URL=https://data.jiuhuang.xyz

模块概览

模块包路径说明
数据jh_quant.data统一数据获取，兼容 akshare / tushare 调用风格，内置 DuckDB 缓存
回测jh_quant.backtest多策略回测，统一价格 schema，风险规则和绩效指标
因子jh_quant.factors因子收益、个股暴露、Fama-MacBeth 验证，支持财务公告日约束
交易jh_quant.tradingbootstrap 模板、模拟盘、实盘 broker、REST API、Dashboard
Dashboardjh_quant.dashboard回测、因子和交易运行可视化

快速验证

获取 TuShare 前复权行情

from jh_quant.data import JHData, DataTypes


jh = JHData()
stock_price = jh.get_data(
    DataTypes.TS_DAILY_QFQ,
    ts_code="000001.SZ",
    start="2025-01-01",
    end="2025-12-10",
)
print(stock_price.head())

启动模拟盘

Terminal window
jh-quant paper

默认使用 paper-compare 模板，自动创建 paper-turtle（海龟策略基准）和 paper-momentum（默认用户策略）两个并行模拟场景，并自动打开 trading Dashboard。

只启动 API：

Terminal window
jh-quant paper --no-dashboard

启动实盘

Terminal window
jh-quant live

运行前需要设置 MiniQMT / xtquant broker 环境变量：

Terminal window
set MINIQMT_USERDATA_DIR=D:\path\to\userdata
set MINIQMT_STOCK_ACCOUNT=你的资金账号

数据同步

将本地 SQLite 交易数据同步到远程 Postgres / Neon 数据库，配合手机 App 随时随地查看：

Terminal window
jh-quant sync --from trade_paper.db

下一步