examples 目录结构及功能介绍
01_connection - 连接相关
| 文件 | 功能 |
|---|---|
| async_connect.py | 演示 AsyncTdxClient 异步客户端的连接与基本用法，支持 async with 上下文管理器 |
| ping_servers.py | 测量多台通达信服务器延迟并排序，返回按延迟升序排列的服务器列表 |
| connect_best_host.py | 演示三种连接方式：默认配置、自动优选最低延迟服务器、手动指定服务器 |
02_market_info - 市场信息
| 文件 | 功能 |
|---|---|
| market_stat.py | 获取全市场涨跌统计概况（上涨/下跌/平盘家数、总市值、涨跌停数等） |
| security_count.py | 获取指定市场（沪/深/北）的证券总数 |
| security_list.py | 分页获取市场证券列表（每页约 1000 条） |
| security_list_all.py | 获取沪深 A 股完整列表，含通达信行业和申万行业分类映射 |
| security_quotes.py | 批量获取实时五档行情（最多 80 只/次） |
03_kline - K线数据
| 文件 | 功能 |
|---|---|
| security_bars.py | 获取个股各周期 K 线（1分钟~年线，最多 800 条/次） |
| index_bars.py | 获取指数 K 线数据（上证指数、深证成指、创业板指等） |
04_minute - 分时数据
| 文件 | 功能 |
|---|---|
| minute_time_data.py | 获取今日分时数据（240 条，对应 4 小时交易时间） |
| history_minute_data.py | 获取历史某日分时数据 |
05_transaction - 逐笔成交
| 文件 | 功能 |
|---|---|
| transaction_data.py | 获取当日逐笔成交数据（含买卖方向、成交量、价格） |
| history_transaction.py | 获取历史逐笔成交数据 |
06_finance - 财务数据
| 文件 | 功能 |
|---|---|
| finance_info.py | 获取最新财务数据（股本、资产负债、利润、每股指标等约 30 个字段） |
| xdxr_info.py | 获取除权除息历史记录（分红、送股、配股等） |
| company_info.py | 获取公司信息目录与详细内容（公司概况、财务分析、股本结构等） |
| price_limits.py | 计算个股涨跌停价格（区分普通股、ST、科创板、创业板、北交所） |
07_block - 板块信息
| 文件 | 功能 |
|---|---|
| block_info.py | 获取板块信息（行业、概念、风格板块及成分股代码列表） |
08_fund_flow - 资金流向
| 文件 | 功能 |
|---|---|
| fund_flow.py | 获取个股当日资金流向（超大单/大单/中单/小单流入流出） |
| history_fund_flow.py | 获取个股历史日线资金流向序列 |
09_file_download - 文件下载
| 文件 | 功能 |
|---|---|
| report_file.py | 从服务器下载文件（行业映射、板块数据、财报 zip 等） |
10_offline - 离线数据读取
| 文件 | 功能 |
|---|---|
| detect_home.py | 检测通达信安装目录与路径解析 |
| daily_bars.py | 从本地通达信目录读取日线 K 线数据 |
| min_bars.py | 从本地读取分钟 K 线数据（.5/.lc1/.lc5 格式） |
| gbbq.py | 从本地读取股本变迁数据（XOR 加密自动解密） |
| history_financial.py | 从本地读取历史财务数据（.dat/.zip 文件） |
| block_data.py | 读取本地板块数据（系统板块 + 自定义板块） |
| ex_daily_bars.py | 读取扩展市场日线数据（期货、港股、外盘指数等） |
11_mac_quotes - MAC 协议行情
| 文件 | 功能 |
|---|---|
| stock_quotes.py | 批量获取自定义字段报价（最多 80 只/次） |
| quotes_list.py | 按市场分类获取排序报价列表（如全部 A 股涨幅前 10） |
12_mac_kline - MAC 协议 K 线
| 文件 | 功能 |
|---|---|
| stock_kline.py | 获取复权 K 线数据（支持前复权/后复权/不复权） |
| kline_offset.py | 获取 K 线偏移信息（服务器可用 K 线总数） |
13_mac_tick - MAC 协议分时
| 文件 | 功能 |
|---|---|
| tick_chart.py | 获取单日分时图数据（含均价、动量指标） |
| multi_day_tick.py | 获取多日分时图数据（最多 5 天） |
| chart_sampling.py | 获取分时缩略采样（约 240 个价格点，适合绘制缩略走势图） |
14_mac_transaction - MAC 协议逐笔
| 文件 | 功能 |
|---|---|
| transaction.py | 获取逐笔成交明细（支持当日和历史查询） |
15_mac_board - MAC 协议板块
| 文件 | 功能 |
|---|---|
| board_list.py | 获取板块列表（行业/概念/风格板块） |
| board_members.py | 获取板块成分股报价（支持排序和过滤） |
| board_ranking.py | 获取板块涨跌幅排行榜（含主力净流入、涨跌家数） |
| board_summary.py | 获取板块汇总数据（总成交额、主力资金流向） |
| belong_board.py | 查询个股所属板块（行业、概念、风格等） |
16_mac_capital - MAC 协议资金
| 文件 | 功能 |
|---|---|
| capital_flow.py | 获取个股多日资金流向数据（主力/中单/大单/小单净流入） |
17_mac_monitor - MAC 协议监控
| 文件 | 功能 |
|---|---|
| auction.py | 获取集合竞价数据（09:15-09:25 逐笔撮合） |
| unusual.py | 获取市场异动数据（5 分钟涨幅>3%、快速拉升、大笔买入等） |
| symbol_info.py | 获取个股特征快照（价格、成交量、内外盘、换手率等） |
| server_info.py | 获取服务器交易时段信息 |
18_mac_ex - MAC 协议扩展市场
| 文件 | 功能 |
|---|---|
| ex_goods_list.py | 获取扩展市场商品列表（港股主板、美股、期货等） |
| ex_quotes.py | 获取扩展市场实时报价（港股/美股） |
| ex_kline.py | 获取扩展市场 K 线数据（港股/美股/期货） |
| ex_tick_chart.py | 获取扩展市场分时图数据（港股） |
19_unified - 统一客户端
| 文件 | 功能 |
|---|---|
| unified_client.py | UnifiedTdxClient 统一入口，同一连接内访问 A 股和扩展市场 |
20_cli - 命令行工具
| 文件 | 功能 |
|---|---|
| cli_examples.sh | CLI 使用示例大全（ping 测速、K 线、分时、板块等命令） |
21_indicator - 技术指标
| 文件 | 功能 |
|---|---|
| basic_indicators.py | 技术指标计算（MACD、KDJ、RSI、BOLL 等 30 个指标） |
| list_indicators.py | 列出所有可用技术指标及其参数 |
22_backtest_advanced - 高级回测
| 文件 | 功能 |
|---|---|
| backtest_601088_advanced.py | 高级回测演示（滑点模型、TWAP 拆单执行、成本归因分析） |
总结
examples 目录共包含 22 个子目录，涵盖：
- 连接管理：同步/异步客户端、服务器测速、自动优选
- 行情数据：K 线、分时、逐笔成交、五档报价
- 财务数据：财务指标、除权除息、公司信息
- 板块分析：板块列表、成分股、资金流向
- 扩展市场：港股、美股、期货数据
- 离线读取：本地通达信数据文件解析
- 技术指标：30+ 种指标计算
- 回测框架：策略回测、滑点模型、执行分析