Skip to content
JH_QUANT JH_QUANT 文档

安装与概览

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

当前文档版本：0.3.0。

环境要求

  • 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
uv run python run_paper.py

默认会创建 paper-turtle 和 paper-momentum 两个并行模拟场景，并自动打开 trading Dashboard。

只启动 API：

Terminal window
uv run python run_paper.py --no-dashboard

下一步