CNEquity README

项目的 README,来自 github.com/rootSunc/CNEquity。合并为一个 markdown 文件:README.md。

CNEquity · 开源 A股本地数据湖,用于量化研究与回测

CNEquity · 中国市场金融数据湖

免注册、免 Token · 复权与 PIT 内置 · 保留退市股 · 行级溯源 · MCP 原生

CNEquity 是开源的中国 A股本地数据湖:整理沪深股票行情、股票数据、财务与期货数据,面向量化研究、量化交易与回测。86 个数据集落到本地 Parquet,可增量续跑,也能通过 MCP 让 AI 直接查 A 股。

CI PyPI Python 3.11+ Apache-2.0 GitHub stars Glama MCP score

English · 完整文档 · 数据集目录 · 更新日志

cne serve 控制台录屏:A股数据湖状态、覆盖热力、日线详情与质量审计

cne serve 控制台真实录屏。

为什么用 CNEquity

和常用取数工具的区别(完整说明见对比页):

AKShare Tushare Pro Baostock CNEquity
账号与 Token 不需要 注册 + Token,按积分开放 不需要,匿名登录 基础采集不需要
数据落盘与增量 调用方自己做 调用方自己做 调用方自己做 本地 Parquet,内置增量与续跑
退市股与 PIT 财报 取决于接口 取决于接口 部分提供 保留退市股,财报按公告日严格 PIT
行级溯源 无 无 无 每行带来源、版本和抓取时间
给 AI 用 自己封装 自己封装 自己封装 cne mcp 只读接入

快速开始

需要 Python 3.11+(macOS / Linux / Windows),不需要账号或 token。

① 一分钟试用。 用真实数据源抓 5 只股票最近 30 个交易日,建在独立目录里,不影响以后的正式湖:

pip install cnequity
cne init --profile demo   # 约 1 分钟;结束时打印行情表、查询示例和接给 AI 的命令
cne serve --config configs/cnequity.demo.toml   # 在浏览器里打开上面的控制台

② 让 AI 直接查 A 股。 把湖以只读方式接给 Claude、ChatGPT、Codex、Gemini CLI、Cursor、VS Code 等支持 MCP 的客户端(--config 用绝对路径)。以 Claude Code 为例:

claude mcp add cnequity -- cne mcp --config /abs/path/to/configs/cnequity.demo.toml

各家客户端的写法见 MCP 接入指南;ChatGPT 只接公网网址,用 cne mcp --http --token 加隧道接入。然后直接问:「宁德时代最近 30 个交易日的最高收盘价是哪天?」

在 Claude Code 里通过 cne mcp 查询 A股:宁德时代最近 30 个交易日的最高收盘价

真实 MCP 工具调用与返回;收盘价为未复权价。

③ 建正式湖。 沪深京全市场、最近 3 年:

cne init     # 开始建正式湖,支持中断续传
cne check    # 检查数据是否完整、可用
from cnequity.query import load

bars = load("daily_bars", symbols=["600519.SH"])
print(bars.tail())

之后每天运行一次 cne run daily 保持更新。想要更长的历史,或了解 init 具体做了什么,见初始化指南。

能用它研究什么

你的问题 数据与入口
跨分红、送转后的历史收益 daily_bars + adj_factors · 复权示例
某个调仓日已经知道哪些财报信息 financial_statement_items · PIT 示例
历史股票池、退市前行情 instruments、trading_status、delisting_events · 股票池画像
估值、资金流、行业轮动 valuation_metrics、资金面与结构数据 · 查询指南
期货期限结构、期权链与 Greeks 逐合约行情和派生数据 · 衍生品指南

数据范围

支持 86 个数据集(78 个 curated、8 个 derived),按用途分为 L0–L9。字段、主键、历史起点和来源见数据集目录与数据源说明。

层次 研究用途 代表数据集
L0 基础参考 证券主数据、交易日历、交易状态
L1 行情 日线、指数、复权因子、可选分钟线与分笔、退市事件
L2 公司事件 公司行为、公告索引、业绩披露预约
L3 基本面 财报、估值、股本、股东、一致预期
L4 资金面 北向、融资融券、龙虎榜、大宗交易、资金流
L5 结构行业 指数成分、行业与板块成分、行业指数
L6 宏观 宏观指标、市场宽度
L7 舆情与轮动 新闻、快讯、情绪、人气、板块行情与资金流
L8 风险合规 解禁日程、监管事件
L9 衍生品 期货与期权合约、逐合约行情、连续合约、Greeks、分钟线

分钟线、分笔、期货/期权,以及资金流、新闻、人气榜等拓展数据集默认关闭,需要时用户自行打开。

架构

CNEquity 从多源采集、编排到本地 Parquet 湖及研究消费的架构图

幸存者偏差

今天的名单不能代替历史股票池。

A股回测幸存者偏差:含退市股与只留幸存者的历史等权持有结果对比

日常更新与升级

cne schedule install   # 为当前用户安装每日定时任务(macOS / Linux / Windows)
cne run daily          # 或者自己每天运行一次
cne check              # 验收;有缺口或质量 error 时返回非零

升级:pip install -U cnequity,然后 cne config upgrade 和 cne migrate(先预览,确认后加 --apply)。调度、操作页和失败后续见日常运维,范围与续跑见初始化指南。

适合与边界

适合持续积累历史、反复查询和自托管。

项目处于 0.x,不含回测引擎或下单。代码采用 Apache-2.0,数据另受上游许可约束,仓库不附带数据湖。

文档与参与

想做什么 从这里开始
安装、跑通首个查询 安装 · 快速开始
常见问题 免费获取 A股历史数据 · 回测避免未来函数 · 用 AI 查 A股 · 与 AKShare、Tushare、Baostock 对比
找数据、确认口径 目录 · 字段 · 研究示例
查命令、参数和副作用 CLI · 参数默认值 · 联网与写入清单
配调度、处理失败 运行手册 · 取数与源保护 · 排障
理解产品方向与反馈问题 产品设计 · 升级与反馈

欢迎提交带最小复现的 Issue、文档修正或数据适配 PR。研究引用见 CITATION.cff;安全问题请按安全策略私下报告。

觉得有用?点一个 Star,或把项目分享给同样在维护 A 股数据的人。

CNEquity (rootSunc/CNEquity)

正在搜索数据库…

这是什么?CNEquity 是面向中国 A 股市场的本地数据基础设施:它将多个来源的股票行情、期货、基本面、公司事件和资金流向数据整理成本地 Parquet 数据湖,支持增量采集、失败后断点续传、质量审计和统一查询。
这是 Python 库、命令行工具,还是别的什么?三者兼有:一个命令行工具(cne 命令)用于构建和更新数据湖;一个 Python 接口(load()/scan())用于以 Polars DataFrame 形式查询;还有一个只读的 MCP 服务器,让 AI 智能体也能查询同一个数据湖。
我该怎么让它运行起来?在 macOS、Linux 或 Windows 上安装 Python 3.10+ 即可,无需账号或令牌。先运行一分钟的试用,将 5 只股票最近 30 个交易日的数据拉取到独立的沙盒目录中;然后构建覆盖全部市场、近 3 年的完整数据湖,并每天运行 'cne run daily' 保持数据最新。
底层数据源需要 API 密钥吗?基础采集不需要账号或令牌;只有部分可选的补充数据源需要你自行提供凭据。
它包含回测引擎或交易信号吗?不包含。CNEquity 纯粹是数据基础设施,不提供回测引擎、交易信号或下单执行功能;它目前仍处于早期的 0.x 阶段,PyPI 上发布的版本可能落后于文档。
Claude 或 ChatGPT 等 AI 智能体如何查询这些数据?通过 MCP 以只读方式将本地数据湖开放给 Claude、ChatGPT、Codex、Gemini CLI、Cursor 或 VS Code 等客户端;MCP 服务器提供六类工具:数据说明、代码查询、行情、财务、通用数据集和 SQL。
为什么不直接调用 AKShare 或 Tushare?CNEquity 将这些原始数据源整理成持久化、带版本的 Parquet 数据湖,支持增量更新、质量审计,以及 PIT(时点数据)和幸存者偏差安全的查询语义,因此重复研究时无需反复拉取数据,也不会悄悄丢失已退市股票的历史记录。
这能防范哪种幸存者偏差问题?如果回测只使用当前仍在交易的股票,就会悄悄漏掉之后退市的标的,从而虚增回测结果;CNEquity 在数据层保留已退市股票的身份信息以及历史指数和行业成分股,使研究不会丢失这些数据。
首次构建后,如何保持数据湖更新?设置计划任务,每天运行一次 'cne run daily'(包括周末):在交易日,它会刷新行情和已启用的日频数据组;在非交易日,则更新公告、监管事件和新闻。'cne check' 用于校验数据湖,发现缺口或质量错误时以非零状态码退出。
作者
rootSunc
大小
59 MB
星标
1.1K
时长
4个月
提交 · 90 天