a-stock-data

<p align="center"><b>简体中文</b> | <a href="README_en.md">English</a></p>

<h1 align="center">a-stock-data</h1>

<p align="center">
  <b>A 股全栈数据工具包 — 15 层架构 · 87 个端点 · 34 个数据源 · 零鉴权（iwencai 除外）</b>
</p>

<p align="center">
  行情 K 线 · 研报 · 市场信号 · 资金面 / 筹码 · 新闻 · 基础财务 · 公告 · 打板 · ETF 期权 · 舆情互动 ·
  宏观与利率 · 指数与交易日历 · 期货与大宗商品 · 事件驱动 · 可转债
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a>
  <img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python">
  <a href="https://github.com/simonlin1212/a-stock-data/stargazers"><img src="https://img.shields.io/github/stars/simonlin1212/a-stock-data?style=social" alt="Stars"></a>
  <br>
  <img src="https://img.shields.io/badge/layers-15-2ea44f.svg" alt="Layers">
  <img src="https://img.shields.io/badge/endpoints-87-2ea44f.svg" alt="Endpoints">
  <img src="https://img.shields.io/badge/sources-34-2ea44f.svg" alt="Sources">
  <img src="https://img.shields.io/badge/auth-zero-success.svg" alt="Zero Auth">
</p>

---

<p align="center">
  <a href="#数据覆盖15-类">数据覆盖</a> ·
  <a href="#架构">架构</a> ·
  <a href="#快速开始">快速开始</a> ·
  <a href="#87-个端点能力清单">端点清单</a> ·
  <a href="#使用示例">使用示例</a> ·
  <a href="#faq">FAQ</a> ·
  <a href="./CHANGELOG.md">更新日志</a>
</p>

一个自包含的 Skill 文件，把分散在 34 个数据源里的 A 股及相关市场原始数据整合成 AI 编程助手直接能用的工具集。你不用再背腾讯 K 线的分段参数、通达信盘后包的二进制格式、东财的 PDF Referer 头、iwencai 的 X-Claw 鉴权——全部封装好了。主源被封还有「备用源速查」可降级。

> 兼容 [Claude Code](https://github.com/anthropics/claude-code) · [Codex](https://github.com/openai/codex) · [OpenClaw](https://github.com/openclaw/openclaw) · [WorkBuddy](https://www.workbuddy.cn/) · [Muse](https://muse.ai/) · [Grok Bot](https://x.ai/bot)
>
> Skill 文件本质是结构化 Markdown + 内嵌 Python，任何支持上下文注入的 AI 编程助手都能用。

> **V3.10.4（2026-11-04 · #64 基金复权）：** §1.6 新浪复权因子用于基金（ETF / LOF）时原来只读 `f`（基金恒为 1），复权等于没做。现在补读份额折算比例 `s` 和累计每份分红 `u`：前复权 `raw / s - u`，后复权 `(raw + u) * s`。个股的返回值、入口数、来源数都不变。
>
> **V3.10.3（2026-10-23 · 上证e互动时间列）：** §10.3 `sse_e_interaction()` 的回复时间是相对写法（`昨天 18:22`），原来只认绝对时间，遇到就整页抛错。现在相对/绝对时间都换算成 `YYYY-MM-DD HH:MM`（按北京时间），认不出仍然报错。入口数、来源数、返回的数据都不变。
>
> **V3.10.2（2026-10-11 · #58）：** 修正 `full_valuation()` 的 PE 消化年数：前向 PE 高于 30x 而预测盈利不增长（或下一年预测缺失）时，原来返回 0 年，像是已经消化完；现在返回 `None`，表示无法估算。当年 EPS 缺失或不为正时同样返回 `None`。入口数、来源数不变。
>
> **V3.10.1（2026-10-07 · #57）：** 更正 §1.2 腾讯 K 线的成交量单位：**科创板（688 / 689）是股**，其余是手。此前文档全写成手，照旧文档换算科创板会大 100 倍。同时补上和通达信盘后包、Baostock 按股对账的口径。§1.4 逐笔改走复用连接、自动重试的会话（一次约 70 秒 → 约 25 秒），新增 `frame.attrs["complete"]`，15:31 以后核对盘后定价段有没有缺笔；§13.7 期货日 K 同样自动重试。入口数、来源数、返回的数据都不变。
>
> **V3.10.0（2026-09-22）：** 通达信公开服务器的 K 线 / 盘口 / 逐笔命令失效（#52）后，行情层把可用来源排到前面（腾讯 → 腾讯 K 线 → 通达信盘后包 → 腾讯逐笔），mootdx 移到最后留档；新增 §1.4 `tencent_ticks()` 腾讯当日逐笔成交（替代 mootdx 逐笔）和 §13.7 `futures_kline()` 新浪期货日 K（主力连续 + 具体合约，**补上大商所**）。Layer 1 重新编号，旧编号对照见 CHANGELOG。
>
> **V3.9.0（2026-09-20）：** 新增期货与大宗商品、事件驱动、可转债三层，并在原有各层补上腾讯 K 线、通达信官网盘后包、新浪研报、ETF 份额、利率曲线等入口，共 25 个；通达信公开服务器的 K 线命令失效（#52）已改走 HTTP。详见 [CHANGELOG](./CHANGELOG.md)。

--