通达信行情拉取总是超时？用 mootdx 三步拿到 A 股数据

通达信行情拉取总是超时？用 mootdx 三步拿到 A 股数据

【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx

上个月排查一个通达信日线脚本：第一轮报ConnectionError: timed out，第二轮轮询 20 次全是空 DataFrame，最后花了两个小时手工核对字段和字节偏移。这类事不必从零踩坑，mootdx 把通达信的行情协议、本地文件、财报下载整条链路封装成了 Python 对象，你只需要拿到 DataFrame。

mootdx 的定位与边界

把 mootdx 理解成一个"通达信数据统一出口"：它不生产数据，只负责把三种来源——公开行情服务器、通达信安装目录下的.day/.lc1文件、财务 zip 包——转换成列名固定的 pandas DataFrame。它不替代行情软件，也不提供信号计算，只做数据获取与格式归一。

从 0 到第一行行情数据

先按官方建议装完整依赖，再建一个脚本验证链路是否通：

pip install -U 'mootdx[all]'

from mootdx.quotes import Quotes client = Quotes.factory(market='std') # std 股票市场；ext 为期货等扩展市场 df = client.quotes(symbol='600519') # 拉取实时行情 print(df[['code', 'name', 'price']])

预期输出：

code name price 0 600519 贵州茅台 1450.00

如果这一步跑通了，说明服务器节点和协议链路都没问题；卡在这里，优先检查网络或换下面的bestip手段。

三条数据通路

• 实时行情：Quotes走公开行情服务器，提供盘口、日/周/月/分钟 K 线、分时、指数和除权除息，代码在 mootdx/quotes.py。轮询、回测取数都用这条链路。
• 本地文件：Reader直接解析通达信数据目录（vipdoc下的.day、.lc1等文件），不联网、不占服务器配额，代码在 mootdx/reader.py。离线分析、补齐历史数据用它。
• 财务数据：Affair拉取上市公司财报 zip 清单并解析成表格，代码在 mootdx/affair.py。做基本面因子起步用这条链路。

完整参数说明可查 docs/quick.md，覆盖以上三条通路的调用示例。

三级实战演练

基础级：取单只股票 K 线。一次连接、一条调用，frequency=9对应日 K：

client = Quotes.factory(market='std') # frequency=9 为日K线, offset 控制条数 df = client.bars(symbol='600519', frequency=9, offset=5) print(df[['open', 'high', 'low', 'close', 'volume']])

组合级：实时价对照本地历史收盘价。行情和 Reader 各取一端，验证两个数据源是否对齐：

from mootdx.reader import Reader reader = Reader.factory(market='std', tdxdir='C:/new_tdx') # 指向 vipdoc 所在目录 now = client.quotes(symbol='600519')['price'].iloc[0] # 线上最新价 hist = reader.daily(symbol='600519').tail(1)['close'].iloc[0] # 本地最新收盘 print(now, hist) # 两者差异只在盘口波动范围内才说明数据源一致

调优级：心跳 + 自动重连 + 测速。长驻脚本把连接参数一次配齐：

client = Quotes.factory( market='std', heartbeat=True, # 保活，防服务器空闲踢连接 auto_retry=True, # 断线自动重连 bestip=True, # 构造时自动挑最快节点 timeout=15, ) df = client.bars(symbol='600519', frequency=9, offset=10)

稳定性建议：连接复用与服务器选择

1. 连接建在循环外。Quotes.factory每次都是一次完整握手，定时任务里在while内部反复建连是超时的常见来源，复用一个 client 即可。

2. 用 bestip 选节点。官方行情服务器不止一台，一条命令测速并写入本地配置：

   python -m mootdx bestip -vv

3. 显式设置 timeout。默认 15 秒，弱网环境可放大到 20~30 秒，避免握手阶段就抛timed out；同时确认auto_retry为True，空返回时会触发重连。

常见疑问

没装通达信软件，能用吗？能用。实时行情直连公开行情服务器，不依赖本机软件。只有Reader读历史文件时需要一个通达信数据目录（之前装过通达信留下的，或从其他机器拷贝的vipdoc）。

返回空 DataFrame 说明什么？说明链路没通或代码不属于沪深市场。to_data收到空结果时返回空表而不是抛异常，把它当断线信号处理，配合auto_retry=True会自动重连后重试。

列名需要自己映射吗？不需要。所有接口统一返回 DataFrame，vol已映射出volume列，date/datetime会转为时间索引，直接进分析流程。

现在动手

mootdx 的价值在于把通达信数据获取中最琐碎的协议和格式问题收敛成三个工厂方法。现在打开终端，执行python -m mootdx bestip -vv，把最快节点测出来，再用上面的最小示例替换成你真正跟踪的代码，数据管道就跑起来了。

【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx