free-stockdb 是一款面向中国股市(A股)投资者和量化研究员的轻量级本地化数据引擎。它不是又一个爬虫或API封装工具,而是一个真正“把数据装进你电脑硬盘”的完整解决方案——从日K线到1分钟、5分钟ETF行情,甚至tick级数据,全部自动下载、清洗、复权、索引并落盘;所有查询、指标计算、回测都直接跑在本地,不依赖网络、不碰限频、不看服务器脸色。如果你曾为全市场回测卡在“等数据”上熬过整夜,它就是为你而生。
核心功能
- 全周期A股数据本地化:支持A股全部股票的日线、周线、月线,以及1/5/15/30分钟K线;覆盖主流ETF分钟级行情,还可按需扩展tick级原始数据。
- 智能增量同步引擎:基于Zstd压缩传输与断点续传机制,仅同步变化部分;配合
sync_url.txt灵活配置数据源,Windows/macOS/Linux三端即将全面支持。 - 开箱即用的复权与清洗:内置完整分红送转数据库与动态复权因子,查询时实时计算前复权/后复权价格,自动处理停牌、退市、代码变更等棘手问题。
- 毫秒级批量指标计算:预置MA、MACD、KDJ、RSI等39种技术指标 + 上证、深证、创业板等5大指数,Rust核心计算性能比pandas快3倍,7000+股票全市场指标生成仅需数秒。
- 五种零门槛调用方式:Python SDK直连调用、HTTP RESTful API、Excel/WPS插件拖拽分析、内嵌HTML可视化界面、AI Agent兼容MCP协议——研究、回测、教学、实盘均可无缝接入。
- 板块与概念智能映射:内置申万一级至三级行业分类 + 超1200个主流概念板块(如“AI芯片”“低空经济”),
bk.get("人工智能")即可毫秒返回关联股票池,省去手动整理标签的麻烦。
适合哪些人用
✅ 个人量化爱好者:想用Python写策略但被Tushare/akshare限频卡住?free-stockdb让你在自己电脑上拥有“全市场分钟库”。
✅ 高校金融/计算机专业师生:课程设计、毕业论文需要稳定、可复现、可离线的数据底座?它开箱即用,无需搭建数据库、写ETL脚本。
✅ 私募与券商量化研究员:高频回测、多因子挖掘、板块轮动分析对数据吞吐与延迟敏感?本地C++时序引擎保障毫秒响应。
✅ 财经自媒体与知识博主:用Excel做技术分析图表、用HTML做交互式K线演示?它原生支持,所见即所得,发布即可用。
快速上手
目前提供 Windows 版本(v0.2.1),下载解压后:
❶ 双击 free-stockdb.exe 启动(首次运行会自动初始化数据目录);
❷ 点击界面上的“双击更新”按钮,自动完成全市场日线同步(约10–15分钟,后续增量仅需几秒);
❸ 打开浏览器访问 http://localhost:8080 使用网页版分析工具,或导入Excel插件直接读取本地数据;
❹ Python用户安装SDK:pip install free-stockdb,一行代码获取任意股票分钟线:df = fsd.get_kline("000001.SZ", freq="5m")。
Mac与Linux版本已在开发中,预计近期上线。
项目信息
面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎,集成增量同步、本地缓存、复权、批量查询、回测与指标计算。
1.3k
今日 +50 stars today
Stars
211
Forks
HTML
MIT
编程语言:HTML(前端界面) + Rust/C++(核心引擎) + Python(SDK)
GitHub Star 数:1290
开源协议:MIT
GitHub 项目地址
如果你厌倦了为数据折腾一星期却还没跑出第一条回测曲线,free-stockdb 就是那个帮你把“数据工程时间”从15天压缩到15分钟的本地化答案。




