free-stockdb快速开始:双击更新+双击启动,新手第一份A股分钟K数据
【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎,集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb
free-stockdb是一个面向 A 股的本地量化数据引擎,覆盖日K、分钟K与 ETF 分钟、tick 级数据,内置增量同步、本地缓存、复权、批量查询、回测与指标计算。它的上手方式简单到只有两步:双击"数据更新"同步数据,双击"stockdb"启动数据库,30 分钟内即可从零跑通第一份全市场 A 股分钟K数据,不再依赖远程接口。
🚀 为什么新手需要本地量化数据引擎
全市场 7000+ 股票的分钟线回测,卡点从来不是策略代码,而是数据工程:
| 环节 | 在线 API 方案 | free-stockdb |
|---|---|---|
| 数据下载 | 逐股请求,受限频/封号约束,实测 3-5 天 | 镜像增量同步,断点续传,进度可见 |
| 数据清洗 | 停牌、退市、缺失补拉,1-2 天 | 同步流程自动完成 |
| 复权处理 | 推算复权因子、历史回刷,1-2 天 | 内置复权因子,查询时即算 |
| 指标计算 | pandas 全市场遍历数小时 | 内置 39 指标 + 5 种指数,数秒完成 |
合计下来,远程 API 方案至少10-15 个工作日才能跑通第一个全市场策略;而 free-stockdb 将数据更新与策略研究完全解耦,30 分钟从零到可运行。
⏱️ 两分钟开始:双击更新 + 双击启动
发行包中只有两个核心文件,详见 先看!这个!!使用说明.txt:
| 文件 | 作用 |
|---|---|
数据更新.exe | 双击后自动从数据镜像同步最新数据到./data目录 |
stockdb.exe | 双击后启动本地数据库服务(仅 2.2MB,监听127.0.0.1:7899) |
第一步:双击"数据更新.exe"同步数据
- 双击运行,同步器会读取 sync_url.txt 配置的数据源,按清单逐个下载并校验 SHA-256;
- 首次同步耐心等待完成,中途退出可以多次重启,已下载文件会跳过,支持断点续传;
- 之后每日或隔几天运行一次即可,增量同步只处理变化数据。
⚠️ 注意:运行更新前请先退出stockdb.exe。
第二步:双击"stockdb.exe"启动数据库
启动后服务默认只监听本机127.0.0.1:7899,不会暴露到公网。数据完整落盘在./data,离线时也能继续查询、回测和计算。
📊 快速验证:浏览器直接看数据
双击 数据网页版.html,用浏览器打开即可看到本地行情:支持按代码、日期区间、周期频率(日K/分钟K)和复权类型筛选,可导出 Excel/CSV——上面配图就是 600633 的日K数据看板效果,无需写一行代码。
🔌 五种调用方式,按需选择
| 调用方式 | 适用场景 | 入口 |
|---|---|---|
| Python SDK | 回测、研究、策略开发 | 先运行 pybao/安装.py,参考 调用方式/python/sdk_test.py |
| HTTP API | 任意语言集成 | 调用方式/http/http_api.py |
| Excel / WPS 宏 | 表格选股、办公自动化 | 调用方式/excel/wps_js_macro.js |
| HTML 网页 | 无代码浏览行情 | 数据网页版.html |
| AI MCP | AI 工具直接查数据算指标 | 调用方式/ai_mcp/stock_mcp_server.py |
Python 端一行rd.get_data()即可批量拉取全市场任意周期、任意复权方式的数据;zb.get()一次算出 MA、MACD、KDJ 等 39 种指标。
❓ 新手常见问题
需要多少磁盘空间?日线约 5GB,全量分钟线约 20GB(Zstd 压缩存储,比 CSV/MySQL 小 3 倍以上),内存 2GB 起步。
数据源可以换成自己的吗?可以。修改 sync_url.txt 指向自己的镜像、内网服务器甚至本地目录(file://),清单格式与安全规则见 docs/DATA_SOURCE.md。
断网了还能用吗?能。同步完成后,查询、回测、指标计算全部走本机数据,与远程链路无关。
Windows 还是 Mac/Linux?均已发布 Windows、macOS、Alpine、manylinux 版本;Windows 用户直接使用发行包即可,无需编译。
📌 小结
free-stockdb 把量化数据工程压缩成了两个动作:双击更新、双击启动。数据在本地、更新与查询解耦、五种调用方式开箱即用——新手也能在 30 分钟内拥有第一份完整的 A 股分钟K数据底座。
【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎,集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考