opentdx 0.1.1

TDX stock data client — A股/期货/港股/美股行情数据接口

opentdx — Python TDX 量化行情数据接口

项目创意来自pytdx

感谢@rainx迈出的第一步

✨ 声明

本项目为个人学习项目，并非已完成的开箱即用的产品，仅用于学习交流

对于数据有迫切需求的朋友，通达信新推出了官方量化平台，建议食用。

由于项目连接的是通达信客户端明文公开的服务器，是财富趋势科技公司既有的行情软件兼容行情服务器，只是简单整理便于大家学习，严禁用于任何商业用途，更严禁滥用接口，对此造成的任何问题本人概不负责。

又因本项目在持续推进中，接口难免会有大幅改动，带来的不便请予宽宥。

应biner建议，本项目精简为基础数据接口库，mcp相关将移动到 tdx_mcp

又因pytdx2库名rainx已经用了，因此本库改名为opentdx，再次致敬rainx

又又，协议基本完成解析了，后期就着力于 tdx_mcp了和少量组合技接口

主要功能

功能	说明	新增
股票行情	A股、创业板、科创板、北交所	✅支持北交所
扩展行情	期货、港股、美股、期权等
K线数据	多周期（1分/5分/日线/周线等）	✅支持复权、即时换手率
分时图	实时/历史分时数据
排行榜	涨跌幅、振幅、换手率等
板块数据	行业/地区/概念板块列表及成分股	🌟 板块K线数据
异动监控	主力监控精灵数据
F10资料	公司基本信息、财报

安装

pip install opentdx

指南

opentdx doc 

快速上手

import pandas as pd
from opentdx.tdxClient import TdxClient
from opentdx.const import MARKET, CATEGORY, EX_MARKET, PERIOD, SORT_TYPE

if __name__ == "__main__":
  with TdxClient() as client:
    # 指数信息
    print(pd.DataFrame(client.index_info([(MARKET.SH, '999999'), (MARKET.SZ, '399001')])))
    # 股票列表（带排序过滤）
    print(pd.DataFrame(client.stock_quotes_list(CATEGORY.A, sortType=SORT_TYPE.TOTAL_AMOUNT)))
    # 股票报价
    print(pd.DataFrame(client.stock_quotes(MARKET.SZ, '000001')))
    # 获取行情全景
    for name, board in client.stock_top_board().items():
        log.info("榜单：%s", name)
        print(pd.DataFrame(board))
    # 获取k线
    print(pd.DataFrame(client.stock_kline(MARKET.SZ, '000001', PERIOD.DAILY)))
    # 获取指数k线
    print(pd.DataFrame(client.stock_kline(MARKET.SH, '999999', PERIOD.MINS, times=10)))
    # 获取历史分时
    print(pd.DataFrame(client.stock_tick_chart(MARKET.SZ, '000001', date(2026, 3, 16))))
    # 获取个股F10
    print(pd.DataFrame(client.stock_f10(MARKET.SZ, '000001')))
    # 历史成交
    print(pd.DataFrame(client.stock_transaction(MARKET.SZ, '000001', date(2024, 1, 15))))
    
    # 期货K线
    print(pd.DataFrame(client.goods_kline(EX_MARKET.SH_FUTURES, 'AUL8', PERIOD.DAILY)))
    # 获取期货行情
    print(pd.DataFrame(client.goods_quotes_list([(EX_MARKET.SH_FUTURES, 'AUL8'), (EX_MARKET.SH_FUTURES, 'AGL8')])))
    # 获取美股K线
    print(pd.DataFrame(client.goods_kline(EX_MARKET.US_STOCK, 'TSLA', PERIOD.DAILY)))
    # 美股行情
    print(pd.DataFrame(client.goods_quotes(EX_MARKET.US_STOCK, 'TSLA')))

🌟 本项目亮点

• ✅ 整体重构：更加简洁易读
• ✅ 协议简化：明确了一些协议的细节，更加清晰易懂
• ✅ 自动选服：自动检查服务器连接速度，并选择最快的服务器
• ✅ 主力监控：新增异动消息的获取
• ✅ 板块列表：像 通达信一样根据板块获取股票列表，支持 深市、沪市、创业板、科创板、北交所
• ✅ 扩展行情：支持 期货、期权、债券、基金、港股、美股等行情的获取
• ✅ 交互式文档：python doc.py一键开启项目探索

#量化交易 #TDX接口 #Python金融

---