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-share): она собирает котировки акций, фьючерсы, фундаментальные показатели, корпоративные события и данные о движении капитала из нескольких источников в локальное хранилище данных в формате Parquet. Поддерживаются инкрементальный сбор, возобновление после сбоев, проверки качества данных и единые запросы.
Это библиотека Python, CLI-инструмент или что-то другое?Это всё сразу: CLI-команда cne для создания и обновления хранилища, Python API (load()/scan()) для запросов с DataFrame из Polars и MCP-сервер только для чтения, чтобы ИИ-агенты могли обращаться к тому же хранилищу.
Как это запустить?Нужен Python 3.10+ на macOS, Linux или Windows; аккаунт и токен не требуются. Начните с пробного запуска за одну минуту: он загрузит последние 30 торговых дней по 5 акциям в изолированный каталог-песочницу. Затем постройте полное хранилище за 3 года по всем рынкам и поддерживайте его в актуальном состоянии, запуская 'cne run daily' каждый день.
Нужны ли мне API-ключи для источников данных?Для базового сбора аккаунт или токен не нужны; только некоторые необязательные дополнительные источники требуют, чтобы вы сами предоставили учетные данные.
Есть ли здесь движок бэктестинга или торговые сигналы?Нет — CNEquity это только инфраструктура данных. В ней нет движка бэктестинга, торговых сигналов или исполнения ордеров, а проект ещё находится на раннем этапе 0.x, поэтому опубликованная версия на PyPI может отставать от документации.
Как ИИ-агенты вроде Claude или ChatGPT работают с этими данными?Локальное хранилище открывается только для чтения через MCP для таких клиентов, как Claude, ChatGPT, Codex, Gemini CLI, Cursor или VS Code. MCP-сервер предоставляет шесть категорий инструментов: описание, поиск кода, котировки, финансовые показатели, общие наборы данных и SQL.
Зачем использовать это вместо прямых вызовов AKShare или Tushare?CNEquity превращает эти сырые источники в постоянное версионируемое хранилище Parquet с инкрементальными обновлениями, проверками качества и запросами с учётом PIT (point-in-time) и survivorship-безопасности, поэтому повторные исследования не загружают данные заново и не теряют историю исключённых из торгов акций.
От какой проблемы survivorship bias защищает этот инструмент?Бэктест только на акциях, которые торгуются сегодня, незаметно отбрасывает бумаги, исключённые из торгов позже, и завышает результаты. CNEquity хранит идентификаторы исключённых бумаг и исторический состав индексов и секторов в слое данных, чтобы исследования их не теряли.
Как обновлять хранилище после первой сборки?Настройте 'cne run daily' на запуск раз в день (включая выходные): в торговые дни он обновляет котировки и включённые ежедневные группы, в остальные дни — объявления, регуляторные события и новости. Команда 'cne check' проверяет хранилище и завершается с ненулевым кодом при пропусках или ошибках качества.
Автор
rootSunc
Размер
59 MB
Звёзды
1.1K
Возраст
4 мес
Коммиты · 90 дней