企业微信

通达信API接口概述

通达信作为国内主流的股票分析软件，其API接口为开发者提供了行情获取、交易下单、数据管理等核心功能。接口以动态链接库（DLL）形式提供，允许用户通过编程语言（如C++、Python、C#）调用，实现自定义策略的自动化执行。通达信API接口主要面向量化交易者，支持实时行情订阅、历史数据查询、账户信息访问及委托交易操作。

行情数据接口

实时行情订阅

实时行情接口通过TdxHq_SubscribeQuote函数实现，该函数接受股票代码列表和回调函数指针，当行情更新时，系统自动调用回调函数传递最新数据。数据结构体TdxQuote包含字段：价格、成交量、买卖五档、时间戳等。用户需在回调中处理数据，例如更新数据库或触发交易信号。


// C++示例：订阅实时行情

#include "TdxHqApi.h"

void OnQuote(TdxQuote* quote) {

    printf("股票代码: %s, 最新价: %.2f\n", quote->code, quote->price);

}

int main() {

    TdxHq_Init();

    TdxHq_SubscribeQuote("600000", OnQuote); // 订阅浦发银行

    // 保持程序运行以接收回调

    while(true) { Sleep(1000); }

    TdxHq_Cleanup();

}

历史数据查询

历史日线、分钟线数据通过TdxHq_GetHistoryData获取。参数包括股票代码、周期类型（日线、5分钟、1分钟）、起始日期和结束日期。返回数据为数组结构，用户可自行存储或转换为DataFrame进行回测。


# Python示例：获取历史日线数据

import ctypes

from ctypes import c_int, c_char_p, byref, POINTER

# 定义结构体

class TdxHistoryBar(ctypes.Structure):

    _fields_ = [("date", c_int), ("open", c_float), ("high", c_float), ("low", c_float), ("close", c_float), ("volume", c_int)]

# 加载DLL

api = ctypes.CDLL("TdxHqApi.dll")

api.TdxHq_GetHistoryData.argtypes = [c_char_p, c_int, c_int, c_int, POINTER(POINTER(TdxHistoryBar)), POINTER(c_int)]

api.TdxHq_GetHistoryData.restype = c_int

# 调用接口

bars = POINTER(TdxHistoryBar)()

count = c_int()

ret = api.TdxHq_GetHistoryData(b"600000", 0, 20230101, 20231231, byref(bars), byref(count))

if ret == 0:

    for i in range(count.value):

        bar = bars[i]

        print(bar.date, bar.close)

交易接口

登录与账户查询

交易接口需要先通过TdxTrade_Login登录，参数为客户号、密码和通信密码。登录成功后，调用TdxTrade_QueryAccount获取资金、持仓等信息。账户结构体TdxAccount包含可用资金、冻结资金、总资产等。

通达信的api接口怎么用


// C#示例：登录并查询账户

TdxTrade_Login("客户号", "交易密码", "通信密码");

TdxAccount account = TdxTrade_QueryAccount();

Console.WriteLine($"可用资金: {account.AvailableFunds}");

委托下单与撤销

委托下单通过TdxTrade_OrderSend实现，参数包括股票代码、买卖方向、价格、数量。支持限价单和市价单。返回值包含委托编号，可用于后续撤单。撤销使用TdxTrade_OrderCancel。


# Python示例：限价买入

api.TdxTrade_OrderSend.restype = c_int

order_id = api.TdxTrade_OrderSend(b"600000", 1, 10.0, 100)  # 买入100股，价格10.0

print("委托编号:", order_id)

# 撤销委托

api.TdxTrade_OrderCancel(order_id)

数据管理与维护

通达信API提供TdxHq_GetSecurityList获取全市场股票列表，TdxHq_GetFinanceInfo获取财务数据。这些接口常用于构建本地数据库。数据更新通过定时任务调用TdxHq_GetHistoryData获取最新数据并增量更新。

策略实现与执行

策略开发流程为：获取行情数据、计算信号、通过交易接口执行。以下为均线策略示例，使用Python实现。


import ctypes

import time

# 初始化接口

api = ctypes.CDLL("TdxHqApi.dll")

api.TdxHq_Init()

# 获取历史数据并计算均线

def get_close_prices(code):

    bars = POINTER(TdxHistoryBar)()

    count = c_int()

    api.TdxHq_GetHistoryData(code.encode(), 0, 20230101, 20231231, byref(bars), byref(count))

    closes = [bars[i].close for i in range(count.value)]

    return closes

# 计算简单移动平均线

def sma(closes, period):

    if len(closes) < period:

        return None

    return sum(closes[-period:]) / period

# 主循环

while True:

    closes = get_close_prices("600000")

    short_sma = sma(closes, 5)

    long_sma = sma(closes, 20)

    if short_sma > long_sma:

        api.TdxTrade_OrderSend(b"600000", 1, 0, 100)  # 市价买入

    elif short_sma < long_sma:

        api.TdxTrade_OrderSend(b"600000", 2, 0, 100)  # 市价卖出

    time.sleep(60)  # 每分钟检查一次

注意事项与风控

通达信API接口使用存在风险：

  • 交易接口需谨慎使用，建议在模拟环境测试充分后再实盘。

  • 行情数据可能因网络延迟导致不准确，需设置超时重试。

  • 高频调用可能触发限频，需控制请求频率。

  • 官方不提供API文档，需通过逆向工程或社区分享获取细节，可能存在不稳定性。

扩展资源

通达信官方没有正式发布API文档，开发者可参考以下资源：

  • GitHub上的python通达信接口包（如pytdx）

  • 通达信公式语言（用于指标开发）

  • 社区论坛中关于接口使用的分享

通达信API接口为量化交易提供了强大的工具，通过编程实现自动化交易与数据分析。开发者需深入理解接口协议，注意风险控制，结合自身策略构建稳定的交易系统。