electkismet / eltdx

eltdx 
 Python API，Rust 驱动的通达信量化数据客户端，支持其他语言通过HTTP或WebSocket调用 
 接口一览 
 ·
 PyPI 
> 如果需要多数据源可以关注新项目 AxData：AxData 基于 eltdx 迭代开发，除通达信体系外，AxData 还通过插件机制整理接入交易所、巨潮、腾讯财经、新浪财经、东方财富、财联社、开盘红等公开源接口，并扩展了自由流通市值、开盘换手、开盘量比、开盘抢筹、竞价昨比、连板天梯、题材强度等更适合本地量化研究和短线数据分析的指标能力，但如果是用单一源的话，仍推荐eltdx，受制于架构axdata性能不如裸协议路径的eltdx。
通达信在线行情协议 Python 库。可以拿 A 股的行情、分时、成交明细、K 线、竞价、公司信息、题材信息等信息，支持 MCP 工具。`3.0` 保留现有 Python API 和返回模型，将 21 个 7709 命令的构包、解析、连接池、pin、push、心跳和关闭核心统一迁入 Rust。
> `v2.0.0` 移除 `TdxClient` 的旧版扁平旧版入口，统一使用模块化 API 和 Helpers。升级前请阅读 v2.0.0 迁移说明。
1. 本项目仅以个人学习、协议兼容性与数据解析研究为目的进行开发。
2. 项目本身、衍生产品及通过本项目获取的数据禁止用于任何商业行为、付费服务、生产服务、转售或其他营利用途，产生的任何数据、损失或法律责任由使用者自负。
3. 对第三方服务器或服务的访问，用户需自行遵守相关法律法规及服务协议。
4. 请勿将本项目用于侵犯他人权益、违反监管规定或滥用第三方服务的行为。
感谢 injoyai/tdx 及 rainx/pytdx 的启发。
## 功能地图
eltdx 默认按“想拿什么数据”组织入口。普通调用优先使用模块化 API 和 Helpers；需要核对底层字段时，再对照 `7709` 命令或 `7615` Entry。下表的代表调用均来自当前接口文档，点击方法名可直接查看参数、返回字段和同类方法。
 Python / MCP 
  → 
 模块化 API / Helpers 
  → 
 7709 原生协议 / 7615 原生 Entry 
  → 
 dataclass / push / JSON 
| 研究任务 | 可以直接拿到 | 代表调用（点开文档） | 数据路径 |
| --- | --- | --- | --- |
| A 股清单 | 最新股票、ST、停牌列表和代码表 | `client.helpers.latest_stock_list()` | `7709` + `Helpers 封装` |
| 分类行情 | 按市场或板块分页、排序的行情列表 | `client.quotes.list_by_category()` | `7709 原生协议` |
| 完整实时行情 | 批量快照、最新价、成交量额和完整五档 | `client.helpers.full_quotes()` | `7709` + `Helpers 封装` |
| 板块行情与成分股 | 所有板块行情、指定板块有效成分股行情 | `client.helpers.board_quotes()` / `client.helpers.board_member_quotes()` | `0x06b9` + `0x044d` + `0x054c` |
| 五档实时刷新 | 为代码列表建立或刷新实时五档 | `client.quotes.get_depth()` | `7709 原生协议` |
| push 队列 | 读取未匹配的实时更新帧 | `client.quotes.poll_push()` | `7709 原生协议` |
| K 线与复权 | 分钟/日/周/月/季/年 K 线、自动分页、前/后/定点复权 | `client.bars.get()` | `7709 原生协议` |
| 退市 K 线 | 退市股票日线、不复权、批量查询、自动分页 | `client.delisted_bars.get()` | `0x052B 原生协议` |
| 当日分时 | 当日每分钟价格、成交量和均价 | `client.minutes.today()` | `7709 原生协议` |
| 当日成交明细 | 自动分页合并的当日完整成交记录 | `client.trades.all_today()` | `7709 原生协议` |
| 集合竞价 | 竞价过程、09:25 撮合、前收盘参考价、开盘价/量/额/涨幅 | `client.helpers.auction_data()` | `7709` + `Helpers 封装` |
| 股本变迁 | 除权除息、股本变化、增发和回购记录 | `client.corporate.capital_changes()` | `7709 原生协议` |
| 财务基础 | 流通/总股本、EPS、资产、负债、收入和利润 | `client.corporate.finance_batch()` | `7709 原生协议` |
| 本地复权系数 | 基于权息记录为已有不复权 K 线提供本地计算和审计系数 | `client.corporate.adjustment_factors()` | `0x000f 本地计算` |
| 特殊品种限制 | 特殊品种涨跌停限制表 | `client.limits.special()` | `7709 原生协议` |
| F10 公司概况 | 发行上市信息、上市日期、发行价、募资额和承销商 | `client.f10.company_profile()` | `7615 原生 Entry` |
| 个股概念 | 某只股票所属的热点题材和入选原因 | `client.helpers.stock_topics()` | `7615` + `Helpers 封装` |
| 股票信息汇总 | 行情、证券名称、股本、市值和换手率合并表 | `client.helpers.stock_profile_table()` | `7709` + `Helpers 组合` |
| 短线指标 | 竞价、开盘量比、流通股本、封单和几天几板等指标 | `client.helpers.shortline_indicators()` | `7709` + `Helpers 组合` |
| A 股常用榜单 | 每日股本、涨跌停价、实时榜单、连板天梯和题材强度 | `client.helpers.realtime_rank()` | `7709` + `Helpers 组合` |
| 服务器文件 | 按分块自动下载并合并完整文件 | `client.resources.download_file()` | `7709 原生协议` |
| 连接与并发 | 主站测速、Rust 连接池、心跳、pin、push、缓存和 diagnostics | `TdxClient()` | `Rust Engine` |
| MCP 工具服务 | 将常用行情、F10、竞价和文档能力提供给 MC