mootdx:通达信数据读取的完整上手教程

mootdx:通达信数据读取的完整上手教程

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

mootdx 是通达信数据读取的 Python 封装,解决两个具体问题:连不上通达信行情服务器、看不懂通达信本地二进制数据文件。它把在线行情、离线 K 线、财务数据下载解析这三类操作封装成几个方法调用,所有结果统一转成 pandas.DataFrame 返回。

先跑起来:从安装到出结果的最短路径

依赖 Python 3.8 及以上,按用途选安装方式:

  • 只用 Python 接口:pip install mootdx
  • 还要用命令行工具:pip install 'mootdx[cli]'
  • 不清楚装什么就用:pip install 'mootdx[all]'

下面这段代码连接行情服务器并拉取最近 100 根日 K 线:

from mootdx.quotes import Quotes # bestip=True 先测速选出最快服务器;timeout 默认 15 秒 client = Quotes.factory(market='std', bestip=True, timeout=15) # frequency=9 表示日K线,offset 单次最多 800 条 df = client.bars(symbol='600036', frequency=9, offset=100) print(df.tail())

跑通后你会看到一个以日期为索引、包含 open/high/low/close/vol 等列的 DataFrame。

三个最值得试的场景

读取本机通达信的历史日线

适合没有稳定网络、或要批量回测历史数据的情况。前提是电脑里装过通达信并下载过数据:

from mootdx.reader import Reader # tdxdir 指向通达信安装目录里的 vipdoc 所在文件夹 reader = Reader.factory(market='std', tdxdir='C:/new_tdx') df = reader.daily(symbol='600036')

坑提示:tdxdir必须真实存在,否则构造时直接抛tdxdir 目录不存在异常,不是返回空值。

拉取在线实时行情和 K 线

盘中监控用quotes(),回测取数用bars()。quotes()支持传入单只或列表,代码前缀会自动识别沪深市场,不用手动传 market。

quote = client.quotes('600036') # 实时行情,返回单行 DataFrame

坑提示:bars()的offset超过 800 会被源码静默截断到 800,想要更多数据要用start参数翻页。

下载并解析财务数据

不需要装通达信也能用。Affair.parse会自动补下载本地缺失的 zip 文件再解析:

from mootdx.affair import Affair df = Affair.parse(downdir='./tmp', filename='gpcw20231231.zip')

坑提示:不带filename调Affair.fetch会用 asyncio 并发下载全部财务包,体积很大,建议先Affair.files()看看清单再挑单个文件。

源码里藏着的3个细节

默认数据源是C:/new_tdx。mootdx/config.py里内置配置settings的TDXDIR默认值就是C:/new_tdx,ReaderBase.tdxdir类属性也是它。在 Linux/macOS 上直接跑文档示例会踩空目录异常,务必显式传tdxdir。

测出的最优服务器会落盘。传bestip=True时,mootdx/server.py的bestip()会逐个探测候选主机(每个连接超时 0.7 秒),把响应时间最短的 IP 写进~/.mootdx/config.json的BESTIP字段。也就是说首次调用Quotes.factory时会发生一次测速写配置,之后复用缓存 IP,不需要重复测速。

除权除息复权藏在参数里。mootdx/utils/__init__.py的to_data()会把adjust='qfq'或'hfq'透传给mootdx/utils/adjust.py的to_adjust()做复权,所以取 K 线时直接client.bars(symbol='600036', adjust='qfq')即可拿到前复权数据,不用自己算因子。

继续深入去哪看

  • docs/quick.md - 最简快速上手,覆盖 bestip 测速、离线读取、在线行情、财务下载四个入口
  • docs/api/quote1.md - Quotes 在线行情 API 参考,查某个方法支持哪些参数
  • docs/api/reader.md - Reader 离线读取 API 参考,含板块文件解析用法
  • sample/ - basic_quotes、basic_reader、fuquan 等可直接运行的最小示例
  • tests/fixtures/ - 真实 vipdoc 数据样本,配合 tests/reader/ 的测试用例看本地文件解析逻辑

适合谁

适合需要免费通达信数据源做回测、复盘的 Python 开发者:本地有通达信目录的用 Reader 离线读,没有的用 Quotes 在线拉,财务数据用 Affair 补齐。下一步建议从 sample/ 里挑一个示例跑通,再按docs/api/逐个方法核对参数。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

STM32F1实战全解析:选型、硬件底子、外设调试与排错思路

STM32F1实战全解析:选型、硬件底子、外设调试与排错思路

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/19 16:32:21 阅读更多 →
第九章:了解特殊场景下的redis

第九章:了解特殊场景下的redis

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/12 21:25:39 阅读更多 →
UFS 3.1协议学习路径:从第11章切入掌握UPIU与命令队列

UFS 3.1协议学习路径:从第11章切入掌握UPIU与命令队列

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/18 10:04:33 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻