mootdx 通达信数据读取上手指南:从安装到出数
【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx
mootdx 是通达信数据读取的 Python 封装,它把本地行情文件、线上实时行情、财务数据统一成 pandas 接口,适合做量化回测和数据分析的开发者。你只要装了通达信客户端或有一份行情数据目录,就能用几行代码拿到日线、分钟线数据。
能做什么
mootdx 把三类数据源收敛到同一套factory工厂方法下,返回的都是标准pd.DataFrame,可直接接后续的指标计算与画图。
| 功能模块 | 能做什么 | 典型场景 |
|---|---|---|
Reader离线读取 | 读取本地日线、1/5 分钟线、板块文件 | 历史回测、本地数据导出 |
Quotes线上行情 | 连接服务器取 K 线、指数、分笔 | 实时策略、盘中监控 |
Affair财务数据 | 下载并解析历史专业财务数据 | 基本面分析、因子研究 |
离线数据目录通常是通达信安装路径下的vipdoc子目录,例如C:/new_tdx/vipdoc/sz/lday/放深圳日线、sh/lday/放上海日线,每只股票对应一个.day文件。
安装与验证
先确认环境满足 Python3.8及以上,然后安装。依赖关系较多时建议用[all]一次装全。
pip install -U 'mootdx[all]'装完用一段最小代码验证能否正常导入并读取数据。Reader.factory的tdxdir必须指向一个真实存在的目录,否则会直接抛异常:
import mootdx from mootdx.reader import Reader print('mootdx', mootdx.__version__) reader = Reader.factory(market='std', tdxdir='C:/new_tdx') print(reader.daily(symbol='600036').tail())预期输出是先打印版本号,再打印最近几根日线(含open/high/low/close/volume等列,索引为日期)。能正常出表说明目录与读取链路都没问题。
典型用法
最常用的是「离线读日线 + 线上取实时行情」这条链路。先用Reader从本地文件取历史数据,再用Quotes从服务器补充最新数据。
from mootdx.reader import Reader from mootdx.quotes import Quotes # 离线:读本地日线 reader = Reader.factory(market='std', tdxdir='C:/new_tdx') df = reader.daily(symbol='600036') # 线上:连接服务器取日 K client = Quotes.factory(market='std', multithread=True, heartbeat=True) bars = client.bars(symbol='600036', frequency=9, offset=10)daily/minute/fzline分别对应日线、1 分钟线、5 分钟线;线上frequency里9代表日 K。需要前复权、后复权时,在取数时传adjust='qfq'或adjust='hfq',接口会自动处理除权除息。如果不想写代码,也可以直接用命令行把数据导出成 CSV:
mootdx reader --tdxdir C:/new_tdx -s 600036 -a daily -o out.csv常见坑与排查
tdxdir 目录不存在:现象是初始化即报错。原因是tdxdir指向了不存在的路径。解决:确认传的是通达信安装根目录(要能往下找到vipdoc子目录),而不是vipdoc本身。- 读到空数据:现象是返回空
DataFrame。原因是本地还没下载该股票的.day文件。解决:先运行通达信客户端做盘后数据下载,或换一只本地确实存在的代码。 - M1 Mac 上依赖报错:现象是
mini-racer相关功能不可用。原因是该依赖对 Apple 芯片支持有限。解决:先用核心行情功能,涉及财务 JS 解析的部分换到其他环境运行。 - 分钟线取不到:现象是
minute返回None。原因是分钟文件有.1/.5与.lc1/.lc5两种后缀。解决:接口会自动判断,确认tdxdir下确有对应分钟文件,必要时用suffix参数指定。
继续深入
- 离线读取与扩展市场、板块文件的完整接口:docs/api/reader.md
- 线上行情的各方法参数与 K 线频率对照:docs/api/quote1.md
- 财务数据字段编号对照表:docs/api/fields.md
- 可直接运行的离线、线上、财务示例:sample/
结语
mootdx 的价值在于把通达信三类数据统一成 pandas 接口,让你跳过格式解析、直接做分析。建议先按「安装与验证」跑通一段最小代码,确认目录读取无误,再逐步替换成你自己的股票代码与数据目录。
【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考