hqdata - A股历史与实时行情数据统一接入、清洗与存储

定位

hqdata 是 HonestQuant 量化系统的数据基础层，职责边界清晰：

• 对下：封装各数据源 SDK，屏蔽接口差异
• 对上：提供统一的查询接口
• 上层策略和引擎只调用 hqdata.api，不直接接触任何数据源

支持的数据源

数据源	状态	说明
AKShare	计划中	免费，实时数据
Tushare	已接入	需满足账户积分要求，支持股票&指数的历史日线
米筐	接入中	需license，支持Tick
迅投	计划中	需迅投终端
iTick	计划中	需注册

安装

方式一：通过pip安装

# 基础安装（仅包含核心功能）
pip install hqdata

# 按需安装数据源依赖
pip install hqdata[tushare]      # Tushare 支持
pip install hqdata[ricequant]    # 米筐支持
pip install hqdata[tushare,ricequant]  # 同时安装两者

# 复制模板并自行填入所需字段
cp .env.example .env # 放在你运行 Python 代码的当前目录（优先）/包安装目录

方式二：本地开发

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate

# 安装依赖 (editable 模式，改代码直接生效)
pip install -e .

# 复制模板并自行填入所需字段
cp .env.example .env # 放在你运行 Python 代码的当前目录（优先）/包安装目录

使用

以 Tushare 为例：

from hqdata import init_source, get_stock_list, get_stock_bar, get_index_list, get_index_bar

# 初始化
init_source("tushare")

# 查询股票列表
get_stock_list()

# 查询日线数据 (symbol 格式: "代码.交易所")
get_stock_bar("000001.SZ", frequency="1day", start_date="20260101", end_date="20260401")

# 查询指数列表
get_index_list(symbol="000300.SH")
get_index_list(symbol="000300.SH,000905.SH")
get_index_list(market="SSE")
get_index_list(market="SSE,SZSE")
get_index_list(symbol="000300.SH", market="SZSE") # 同时传入symbol和market, 只有symbol字段会生效

# 查询指数日线数据
get_index_bar("000300.SH", start_date="20260101", end_date="20260401")
get_index_bar("000300.SH,000905.SH", start_date="20260330", end_date="20260401")

测试

pytest tests/ -v
pytest tests/test_tushare.py::TestTushareIntegration::test_get_stock_bar  # 运行单个测试

输入参数格式说明

股票代码

symbol 参数统一使用 代码.交易所 格式：

交易所	代码	示例
上交所	SH	600000.SH
深交所	SZ	000001.SZ