jh-quant 0.1.1

Jiuhuang quant python sdk

JH_QUANT

量化交易研究与执行平台。支持：免费数据获取、回测、因子计算、 模拟交易、组合优化、可视化仪表盘

• 官网: https://jiuhuang.xyz
• 文档: https://doc.jiuhuang.xyz

模块

模块	说明	文档
data	多种数据获取，兼容akshare和tushare数据类型及调用风格	README
trading	交易运行层，模拟(实时)交易与会话编排	README
backtest	回测引擎，快速策略验证，多种内置策略	README
factors	因子计算，内置多种因子模型	README
dashboard	PyWebView可视化仪表盘	README

快速开始

安装

pip install jh_quant

数据获取

import os
from jh_quant.data import JHData, DataTypes

load_dotenv()   # 读取.env文件, 必须设置JIUHUANG_API_KEY变量

jh = JHData(apt_key=os.getenv("JIUHUANG_API_KEY"))
stock_price = jh.get_data(
    DataTypes.AK_STOCK_ZH_A_HIST_QFQ,  #akshare日线前复盘数据
    symbol="000001",
    start="2025-01-01",
    end="2025-12-10",
)

重要

jh_quant 的数据获取并非像 akshare 那样需要实时抓取数据。
jh_quant 仅做了对 akshare 数据类型的兼容，数据真实来源为：JiuHuang API

实时模拟交易

jh_quant支持同时开启多个模拟交易会话，每个会话对应一个模拟账户, 下面是示例运行:

python run_paper.py

run_paper.py的完整代码参考本repo根目录的run_paper.py

在回填模式下（可以通过enable_backfill=False关闭），会完成历史交易模拟，并在本地开启服务

开启控制台仪表盘 开启本地服务之后, 可以通过如下代码开启控制台仪表盘

from jh_quant.dashboard import display_trading

display_trading()

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.