通达信专业数据源

为什么需要这个技能

进行量化交易或金融数据分析时，获取稳定可靠的股票行情数据是第一道门槛。通达信作为国内主流的行情软件，其背后的数据协议被 pytdx 库封装成 Python 接口，但直接使用存在几个痛点：服务器地址选择困难（不同服务器稳定性差异大）、API 参数复杂（市场代码、K线周期等需要手动配置）、缺乏系统性的使用指南。

这个技能正是为解决这些问题而设计——它不是简单的 API 包装，而是提供了一套完整的参考体系和智能连接策略，让你能专注于数据分析本身，而不是被数据获取的细节困扰。

核心能力与关键步骤

双引擎 API 架构

技能封装了通达信的两大核心接口，覆盖几乎所有金融品种：

| API 类型 | 适用场景 | 典型数据 |
|---------|---------|--------|
| TdxHq_API | A股、B股、指数 | 实时行情、日K线、分钟K线 |
| TdxExHq_API | 期货、期权、港股、美股 | 期货行情、期权链、外盘数据 |

市场代码遵循通达信标准：0 代表深圳证券交易所，1 代表上海证券交易所。K线周期则从 0（5分钟）到 11（年线）共12种选择。

智能服务器选择机制

这是技能的一个核心亮点。它实现了自动化的服务器优选策略：

1. 多维度评分：综合预设权重、历史成功率、响应速度和新鲜度进行打分
2. 故障自愈：连续失败超过3次的服务器会被自动降级
3. 无感切换：默认2次自动重试，无需手动干预

预设的最优服务器（如 115.238.56.198:7709，权重1.0）经过实测验证，确保开箱即用的稳定性。

标准操作流程

一个典型的使用场景如下：

# 1. 连接（使用 with 语句自动管理资源）
with TdxHq_API() as api:
    # 2. 选择市场和股票代码
    market = 1  # 上海
    code = "600519"
    
    # 3. 获取K线数据
    kline = api.get_kline_data(
        market=market, 
        code=code, 
        category=9,  # 日K线（含成交量）
        start=0
    )
    
    # 4. 转换为 DataFrame 进行分析
    df = kline.to_df()

技能还提供了 references/api-reference.md（所有接口的详细参数说明）和 references/usage-examples.md（典型场景代码示例），方便查阅。

适用边界与注意事项

数据来源的局限性：pytdx 通过通达信协议获取数据，本质上是对公开行情数据的抓取，不包含 Level2 深度数据或实时逐笔成交。如果你需要 Level2 数据，需要寻找其他数据源。

网络稳定性要求：由于是实时从服务器拉取数据，网络波动会直接影响数据获取。建议在稳定的网络环境下使用，并做好超时重试机制。

扩展市场的特殊性：期货、期权等扩展市场数据需要使用 TdxExHq_API 和专门的服务器地址，与 A 股使用的标准服务器不同。使用时注意区分 API 类型。

历史数据的起始位置：查询历史数据时，start 参数从 0 开始计数，表示从最新数据向前回溯。如果需要获取特定日期的数据，需要先计算偏移量。

总的来说，这个技能适合需要批量获取股票行情数据进行量化分析的场景，它解决了数据获取的工程化问题，但数据分析和策略开发仍需要你自己的专业判断。