eltdx

极简的通达信在线行情协议 Python 客户端

接口一览 · PyPI

推荐关注新项目 AxData：AxData 基于 eltdx 迭代开发，除通达信体系外，AxData 还通过插件机制整理接入交易所、巨潮、腾讯财经、新浪财经、东方财富、财联社、开盘红等公开源接口，并扩展了自由流通市值、开盘换手、开盘量比、开盘抢筹、竞价昨比、连板天梯、题材强度等更适合本地量化研究和短线数据分析的指标能力，但如果是用单一源的话，仍推荐eltdx，受制于架构axdata性能不如裸协议路径的eltdx。

通达信在线行情协议 Python 库。可以拿 A 股的行情、分时、成交明细、K 线、竞价、公司信息、题材信息等信息，支持 MCP 工具。

v2.0.0 移除 TdxClient 的旧版扁平旧版入口，统一使用模块化 API 和 Helpers。升级前请阅读 v2.0.0 迁移说明。

1. 本项目仅以个人学习、协议研究和非商业研究为目的进行开发。
2. 本项目基于互联网公开信息搜集开发。
3. 项目本身、衍生产品及通过本项目获取的数据禁止用于任何商业行为、付费服务、生产服务、转售或其他营利用途，产生的任何数据、损失或法律责任由使用者自负。
4. 对第三方服务器或服务的访问，用户需自行遵守相关法律法规及服务协议。
5. 请勿将本项目用于侵犯他人权益、违反监管规定或滥用第三方服务的行为。

感谢 injoyai/tdx 及 rainx/pytdx 的启发。

eltdx 功能简介

完整接口目录见 GitHub Pages。调用方法和返回字段看 METHOD_REFERENCE.md，常用问题入口看 docs/helpers/README.md，完整 API 看 API_REFERENCE.md，字段总表看 FIELD_REFERENCE.md，F10 资料看 F10_7615.md，MCP 工具看 MCP.md。

安装

pip install eltdx

如果需要启动 MCP stdio 工具服务，安装可选依赖：

pip install "eltdx[mcp]"

源码目录安装：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -U pip
pip install -e ".[dev,mcp]"

源码开发时建议始终先安装到当前虚拟环境；否则本机如果已有旧版 eltdx，python -m eltdx... 可能导入 site-packages 里的旧包。

安装后可以先看命令帮助：

eltdx-smoke --help
eltdx-f10-smoke --help

MCP 工具服务启动后会占用当前终端作为 stdio 服务：

eltdx-mcp

源码开发自测：

python -m pytest

源码仓库里的 scripts/ 目录用于开发和排查；通过 pip install eltdx 安装后，优先使用上面的命令行入口。

快速开始

查行情走 TdxClient

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    quote = client.quotes.get_snapshots(["sz000001", "sh600000"])
    bars = client.bars.get("sz000001", period="day", count=30)
    minute = client.minutes.today("sz000001")
    ticks = client.trades.all_history("sz000001", "2026-05-20")

print(quote[0])
print(bars.bars[-1])

查 F10 / 资料数据走 client.f10

from eltdx import TdxClient

client = TdxClient(timeout=3)
profile = client.f10.company_profile("000034")
topics = client.f10.hot_topics("000034")
notices = client.f10.announcements("000034")

print(profile.rows[0])
print(topics.rows[:3])
print(notices.rows[:3])

如果只查 F10，也可以直接用轻量 HTTP 客户端：

from eltdx import F10Client

f10 = F10Client(timeout=3)
print(f10.company_profile("000034").rows[0])

行情接口

7709 命令和 API 对照见 COMMANDS_7709.md，完整调用参数见 API_REFERENCE.md。

K 线周期和复权

K 线是最常用的接口之一，周期和复权参数可以直接这样传：

client.bars.get("sz000001", period="day", count=200)
client.bars.get("sz000001", period="week", count=100)
client.bars.get("sz000001", period="year", count=20)
client.bars.get("sz000001", period="1m", count=240)
client.bars.get("sz000001", period="day", adjust="qfq", count=200)
client.bars.get("sz000001", period="day", adjust="fixed_qfq", anchor_date="2024-06-03")

F10 资料接口

F10 返回统一是 F10Response。常用结果在 response.rows，多表结果在 response.tables。完整说明见 F10_7615.md。

连接、并发和缓存

默认 TdxClient() 使用真实 7709 行情主站；不传 host / hosts 时，会读取包内 tdx_server.json。

from eltdx import TdxClient

with TdxClient(host="116.205.183.150:7709", timeout=3) as client:
    print(client.helpers.full_quotes("sz000001"))

with TdxClient.from_hosts(pool_size=4, probe_hosts=True, timeout=3) as client:
    print(client.codes.count("sz"))

pool_size 默认是 1。pool_size=N 表示创建 N 个长期 ConnectionActor 和 N 条 TCP 连接，最多允许 N 个行情网络请求同时在途；它不表示连接 N 个行情服务器。传入多个主站时，每个连接槽位会按不同顺序尝试这些候选主站，连接失败或断开后自动尝试后续主站。

普通顺序调用保持默认 1 即可；需要同时发起多个行情请求时，可以根据实际并发量设置 pool_size=4、pool_size=8 等正整数。0、负数、float、字符串、bool 和 None 会直接抛出 ValueError，不会被自动修改。

每个连接槽位的 Actor 在线程生命周期内持续复用。网络重连只替换它持有的 TCP socket，不会为每次重连再创建一条 reader 线程。建议始终使用 with TdxClient(...) as client:；退出 with 时会关闭 Actor、socket、selector 和 wakeup。手动创建客户端时，需要在 finally 中调用 client.close()。

真实 socket 连接默认每 30 秒自动心跳保活。关闭后台心跳：

client = TdxClient(heartbeat_interval=None)

Helpers 会缓存股本变迁、stock_profile_table() 内部使用的财务批次和已验证的短线统计资源。代码数量、代码表、直接财务查询、实时行情、分时、成交明细和 K 线不缓存。

client.helpers.capital_changes("sz000001", refresh=True)
client.helpers.shortline_indicators("sz000001", refresh_stats=True)
client.clear_cache()

调试和导出

部分接口支持 include_raw=True，用于保留原始 payload 或单条记录 hex，方便排查字段解析问题。

gbbq = client.corporate.capital_changes("sz000001", include_raw=True)
bars = client.bars.get("sz000001", period="day", include_raw=True)
ticks = client.trades.history("sz000001", "2026-05-20", include_raw=True)

返回模型可以直接转 JSON：

from eltdx import to_json, to_jsonable

data = to_jsonable(client.helpers.full_quotes("sz000001"))
text = to_json(data, indent=2)

真实环境 smoke：

eltdx-smoke --timeout 6 --no-heartbeat
eltdx-f10-smoke --code 000034 --timeout 8

源码仓库可运行更多开发脚本，例如批量导出某段日期的 09:25 竞价成交快照：

python scripts/smoke/export_auction_925_daily.py --code sz000001 --start 2026-04-01 --end 2026-04-30

文档

使用文档现在按层级拆开看：

常用问题

• 想拿某个或某些股票的表头信息怎么办？
• 想查询某个股票都有哪些概念板块怎么办？
• 想查询某个概念板块都有哪些股票怎么办？
• 想拿集合竞价数据怎么办？
• 想拿流通市值Z、开盘换手Z、竞价昨比、开盘昨封比、昨封比、封流比和几天几板怎么办？
• 想拿复权或不复权 K 线怎么办？

常用组合调用示例：

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    table = client.helpers.stock_profile_table(["sz000001", "sh600000"])
    shortline = client.helpers.shortline_indicators(["sz000001", "sh600000"])
    topics = client.helpers.stock_topics("000034")
    stocks = client.helpers.topic_stocks("000034", topic_name="存储芯片")
    auction = client.helpers.auction_data("sz000001", "2026-05-20")

print(table.rows[0])
print(shortline.rows[0])
print(topics.topics[:3])
print(stocks.rows[:10])
print(auction.open_price, auction.open_change_pct, auction.open_amount)

完整入口见 docs/helpers/README.md。

联系

• QQ 群：点击链接加入群聊

• 邮箱：dapaoxixixi@163.com

许可证

本项目仅允许个人学习、协议研究和非商业研究使用，禁止一切商业使用和滥用。详细条款见 LICENSE。