通达信行情协议的 Python 库
安装后就能直接调快照、分时、逐笔、K 线、集合竞价等接口，返回结果统一、字段清楚，也支持查看原始十六进制数据。主要用于个人行情研究，请勿用于任何商业或违法用途。
eltdx 优点：
- 一个统一入口：
TdxClient - 让常用接口直接就能调：
get_quote()、get_minute()、get_trades()、get_kline()等 - 返回结果尽量好懂：统一 dataclass，不直接丢一堆裸
dict - 时间字段给 Python 原生
date/datetime - 价格字段同时保留浮点值和
*_milli整数值 - 需要排查问题时，可以打开
include_raw=True看原始十六进制
当前版本重点覆盖：
- 行情快照
- 分时
- 逐笔
- K 线
- 集合竞价
- 公司行为 / 股本变化 / 复权因子
- 一些常用 helper
推荐的安装方式：
python -m pip install eltdx升级：
python -m pip install -U eltdx如果你是拉源码自己调：
pip install -e .环境要求：
- Python
>=3.10
最简单的用法：
from eltdx import TdxClient
with TdxClient() as client:
quotes = client.get_quote(["sz000001", "sh600000"])
for quote in quotes:
print(quote.code, quote.last_price, quote.last_close_price, quote.server_time)如果你想看原始协议数据：
from eltdx import TdxClient
with TdxClient() as client:
minute = client.get_minute("sz000001", include_raw=True)
print(minute.raw_frame_hex)
print(minute.raw_payload_hex)如果你想自己指定服务器地址：
from eltdx import TdxClient
with TdxClient(
hosts=["124.71.187.122:7709", "122.51.120.217:7709"],
pool_size=2,
batch_size=80,
) as client:
quote = client.get_quote("sz000001")[0]
print(quote.last_price)connect()：主动建立连接close()：关闭连接with TdxClient() as client:：适合一次性脚本，跑完自动关
get_quote()：拿快照行情get_minute()/get_history_minute()：拿分时get_trades()/get_trades_all()：拿逐笔get_kline()/get_kline_all()：拿 K 线get_call_auction()：拿集合竞价get_gbbq()/get_xdxr()/get_equity()/get_factors()：拿公司行为、股本和复权相关数据
with可用可不用；短任务推荐用，长连接也可以手动控制get_quote()自带自动分批，不用你自己切列表- 默认支持多连接分发，批量取快照会更稳一些
- 返回字段统一，做展示、落库、计算都比较顺手
它是“这个市场的代码表条目数”，不是“这个市场一共有多少只股票”。
如果你更想拿到股票口径的数量，可以试试：
get_stock_count(exchange)get_a_share_count(exchange)
这里面会混有股票、指数、板块分类项、ETF、基金、债券回购等条目。
如果你想直接拿一组更实用的代码去拉行情，可以试试：
get_stock_codes_all()get_a_share_codes_all()get_etf_codes_all()get_index_codes_all()
- 你只是临时拉一把数据：用
with - 你要一直保持连接：手动
connect()/close()也可以
host=：只测一个地址时比较方便hosts=：传多个地址，交给客户端自己处理- 不传时会回退到库内默认地址列表
如果你是第一次用，建议按这个顺序看：
直接用：
with TdxClient() as client:
...这样最省心，代码块结束后会自动关连接。
那就自己控制连接生命周期：
client = TdxClient()
client.connect()
try:
...
finally:
client.close()因为它不是股票总数，而是代码表条目数。
因为它本来就不只是股票，还会带上指数、ETF、板块分类项等条目。
优先用：
get_a_share_codes_all()
如果你希望把 B 股也一起算进去，再试：
get_stock_codes_all()
- 感谢作者injoyai/tdx
- QQ 群：复盘软件交流群（群号：
982691484） - 加群链接：点击链接加入群聊
- 邮箱：
dapaoxixixi@163.com
MIT