如何快速上手MooTDX：通达信数据读取神器的完整指南

MooTDX是一款基于Python的通达信数据读取接口，专为金融数据分析打造，支持本地数据读取、实时行情获取和财务数据下载，让股票、期货等市场数据处理变得简单高效。

📌 为什么选择MooTDX？

作为通达信数据读取的便捷封装工具，MooTDX具有三大核心优势：

• 跨平台兼容：完美支持Windows、MacOS和Linux系统
• 双模式读取：同时支持本地离线数据和在线实时行情
• 极简API设计：3行代码即可完成数据获取，新手也能快速上手

MooTDX功能架构示意图，展示数据读取的完整流程

🚀 快速安装指南

标准安装（推荐新手）

# 完整安装（包含所有功能）
pip install -U 'mootdx[all]'

定制化安装

# 核心功能安装
pip install -U mootdx

# 命令行工具安装
pip install -U 'mootdx[cli]'

源码安装

git clone https://gitcode.com/GitHub_Trending/mo/mootdx
cd mootdx
pip install .

💻 核心功能使用教程

1. 本地数据读取（离线模式）

通过Reader模块轻松读取通达信本地数据文件：

from mootdx.reader import Reader

# 初始化阅读器（标准市场）
reader = Reader.factory(market='std', tdxdir='C:/new_tdx')

# 获取日线数据
df = reader.daily(symbol='600036')

# 获取分钟线数据
df = reader.minute(symbol='600036')

2. 实时行情获取（在线模式）

使用Quotes模块连接行情服务器：

from mootdx.quotes import Quotes

# 初始化行情客户端
client = Quotes.factory(market='std', bestip=True, timeout=15)

# 获取K线数据
bars = client.bars(symbol='600036', frequency='D', offset=100)

# 获取指数数据
index = client.index(symbol='000001', frequency='W')

3. 财务数据下载

通过Affair模块获取上市公司财务报告：

from mootdx.affair import Affair

# 获取财务文件列表
files = Affair.files()

# 下载单个财务文件
Affair.fetch(downdir='data', filename='gpcw20230331.zip')

⚙️ 命令行工具使用

MooTDX提供强大的命令行工具，无需编写代码即可导出数据：

读取日线数据

mootdx reader --tdxdir "C:/new_tdx" -s 600036 -a daily -o stock_data.csv

下载财务数据

# 列出所有财务文件
mootdx affair -l

# 下载指定文件
mootdx affair -f gpcw20230331.zip -d ./financial_data

📊 应用场景

量化策略开发

快速获取历史K线数据，验证交易策略：

# 示例：获取茅台5年日线数据
df = reader.daily(symbol='600519')

市场分析报告

导出数据至Excel制作可视化图表：

mootdx quotes -s 000001 -a daily -o sh_index.csv

财务数据研究

批量下载年报数据进行基本面分析：

# 下载全部财务文件
Affair.fetch(downdir='financial_reports')

🔧 常见问题解决

数据路径设置

确保通达信数据目录正确，默认路径：

• Windows: C:/new_tdx
• MacOS: /Applications/通达信.app/Contents/Resources

服务器连接问题

自动匹配最优服务器：

client = Quotes.factory(market='std', bestip=True)

复权数据处理

使用内置复权函数调整价格：

from mootdx.utils.adjust import fq_factor
# 计算复权因子
df = fq_factor(df, xdxr=xdxr_data)

📝 总结

MooTDX通过简洁的API设计和丰富的功能，让通达信数据处理不再复杂。无论是量化交易员、金融分析师还是Python爱好者，都能通过这个工具快速获取和分析市场数据。

现在就通过以下步骤开始你的数据之旅：

1. 安装MooTDX
2. 尝试示例代码
3. 探索docs/quick.md获取更多教程

让MooTDX成为你金融数据分析的得力助手，解锁数据驱动的投资决策！🌟