free-stockdb 两步跑通全市场 A 股分钟K 数据
【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎,集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb
free-stockdb 是面向 A 股日K、分钟K、ETF 分钟数据的本地量化数据引擎:全市场行情一次性同步到你自己的磁盘,之后的查询、复权、指标计算全走本机,不再受远程接口限频与封号约束,省掉自己搭数据管道的十几天工作量。数据同步、服务启动完成后,半小时就能跑通第一次查询。
🧩 它解决什么问题
全市场分钟线回测的耗时大头不在策略代码,而在数据工程。传统做法有四个真实痛点:
- 远程接口逐股拉取全市场分钟数据:受限频与封号规则约束,实测要跑好几天。本项目改用镜像增量同步,整包下载、逐文件校验、断点续传,一次拿全市场 7000+ 只股票。
- 停牌、退市、代码变更的缺失补拉要手工处理时间排序,约花 1-2 天。同步流程自动完成清洗与数据组织,落盘即可查。
- 复权要自己找分红送转数据、推算因子、历史回刷,再花 1-2 天。引擎内置完整复权因子,查询时即时计算,前复权、后复权、不复权任选。
- 指标要自己写公式、用 pandas 遍历全市场,单次跑数小时。内置 39 种技术指标与 5 种指数算法,批量计算数秒返回。
📦 安装准备:系统、磁盘与所需文件
环境要求:
| 项目 | 要求 |
|---|---|
| 系统 | Windows 7+;macOS、Linux(含 Alpine、manylinux 构建) |
| 磁盘 | 日线约 5GB,全量分钟K约 20GB,Zstd 压缩落盘,同量数据比 CSV、MySQL 方案省 3 倍以上空间 |
| 内存 | 2GB 起步 |
发行包里你要用到的文件:
| 文件 | 作用 |
|---|---|
| 数据更新.exe | 从镜像同步数据到 ./data |
| stockdb.exe | 数据库服务,体积仅 2.2MB |
| sync_url.txt | 数据源配置,格式与安全规则见 docs/DATA_SOURCE.md |
| stockdb.conf | 服务配置,使用说明 里标注请勿修改 |
Python 用户先运行一次 pybao/安装.py,把 pybao 目录全局加入 Python 路径,之后任何工程里from stock_sdk import *即可。想从源码编译,可 clone 仓库 https://gitcode.com/GitHub_Trending/fr/free-stockdb ,cpp/ 目录构建需要 CMake 3.14+、C++17、libcurl 与 OpenSSL。
▶️ 跑通主流程:同步、启动、网页验证
- 你:⚠️ 先确认 stockdb.exe 没在运行,然后双击 数据更新.exe → 你会看到:它读取 sync_url.txt 里的镜像地址,逐文件下载并核对 SHA-256 校验值,数据写入 ./data。中途可以退出重跑,已完成的文件自动跳过,反复运行直到同步完成。
- 你:同步完成后双击 stockdb.exe → 你会看到:控制台输出启动信息,服务只监听本机 127.0.0.1:7899,不出公网。
- 你:浏览器打开 数据网页版.html → 你会看到:填入代码、起止日期、周期(日K/分钟K)与复权方式即可查行情,结果可直接导出 Excel/CSV,全程零代码。
- 你:(可选)运行一次 pybao/安装.py → 你会看到:控制台提示路径写入成功,重启解释器后,Python 在任意目录都能直连本地服务。
📈 新手第一个用例:查 600633 的日K
以 600633 为例,取 2026-06-23 到 2026-08-04 的前复权日K,两行代码:
from stock_sdk import * k = rd.get_data("600633", start="20260623", end="20260804", frequency="1d", fq="qfq")返回 31 条完整记录:日期、开盘、最高、最低、收盘、成交量、成交额、换手率、总市值、市净率等字段一次给全。同样的查询在网页版里的结果如下:
🧰 跑通之后能做什么
| 场景 | 入口文件 |
|---|---|
| 回测、研究与策略开发 | 调用方式/python/sdk_test.py |
| 任意语言接入本地数据 | 调用方式/http/http_api.py |
| 表格选股、办公自动化 | 调用方式/excel/wps_js_macro.js |
| 零代码浏览行情 | 数据网页版.html |
| Cursor、Claude 等 AI 工具直查数据算指标 | 调用方式/ai_mcp/stock_mcp_server.py |
zb.get()一次批量算出 MA、MACD、KDJ 等指标;bk.get()可做股票与申万一二三级、1200 个概念板块之间的毫秒级双向查询。
⚠️ 常见坑与处理
- 现象:同步报错或文件写入被拒 → 原因:stockdb.exe 还在运行,数据文件被占用 → 处理:先关闭服务窗口,再执行 数据更新.exe。
- 现象:Python 里 import 不到包 → 原因:pybao 还没加入 Python 路径 → 处理:运行一次 pybao/安装.py,重启解释器或 IDE。
- 现象:查询返回空 → 原因:该代码或日期区间还没同步到 → 处理:在网页版页面顶部查看数据截至日期,把查询范围收进已同步区间。
- 现象:更新程序没有任何动作 → 原因:sync_url.txt 为空或镜像不可达 → 处理:改成你的镜像、内网服务器或本地目录(file://),细节见 docs/DATA_SOURCE.md。
下一步
两次双击之后,free-stockdb 就把全市场日线与分钟K的本地数据底座放到你的磁盘:更新与查询互不干扰,断网也能继续研究。建议接着读 先看!这个!!使用说明.txt 与 docs/DATA_SOURCE.md,把数据源换成自己的镜像,就拥有完全自主的数据链路。
【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎,集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考