TDX期货常规数据接口是通达信软件提供的用于获取期货行情数据的接口，它允许开发者通过编程方式获取实时行情、历史数据等信息。将对TDX期货常规数据接口进行全面解析，帮助开发者快速掌握其使用方法。

连接数据接口

要连接TDX期货常规数据接口，需要使用通达信提供的DLL文件。将DLL文件复制到项目的bin目录下，然后在代码中加载DLL并创建数据接口对象。

using TdxApi;

...

// 加载DLL文件

TdxHqApi.TdxHqApiClass api = new TdxHqApi.TdxHqApiClass();

// 连接数据接口

api.Connect();

获取实时行情

连接数据接口后，可以通过GetRTimeData()方法获取指定合约的实时行情数据。该方法的第一个参数为合约代码，第二个参数为输出数据结构的地址。

// 获取IF2303合约的实时行情

StructRTimeData rtd;

api.GetRTimeData("IF2303", ref rtd);

返回的StructRTimeData结构体包含了合约的实时行情信息，包括最新价格、涨跌幅、成交量等。

获取历史数据

除了实时行情，还可以通过GetHisData()方法获取指定合约的历史数据。该方法的第一个参数为合约代码，第二个参数为历史数据类型，第三个参数为开始时间，第四个参数为结束时间，第五个参数为输出数据结构的地址。

// 获取IF2303合约从2023-03-01到2023-03-08的日线历史数据

StructHisData[] hisData = new StructHisData[1000];

api.GetHisData("IF2303", TdxHqApi.TdxHqApiClass.HisDataType.HisDataType_Day, "2023-03-01", "2023-03-08", ref hisData);

返回的StructHisData数组包含了合约的历史数据，包括日期、开盘价、最高价、最低价、收盘价、成交量等。

订阅行情数据

为了实时接收行情数据的更新，可以使用Subscribe()方法订阅指定合约的行情数据。该方法的第一个参数为合约代码，第二个参数为订阅类型。

// 订阅IF2303合约的实时行情

api.Subscribe("IF2303", TdxHqApi.TdxHqApiClass.SubscribeType.SubscribeType_RTime);

订阅成功后，当合约的行情数据发生变化时，会触发OnRTimeData()事件。

private void api_OnRTimeData(string code, StructRTimeData rtd)

{

// 处理实时行情数据

}

取消订阅

订阅行情数据后，如果不再需要接收实时更新，可以使用UnSubscribe()方法取消订阅。

// 取消订阅IF2303合约的实时行情

api.UnSubscribe("IF2303", TdxHqApi.TdxHqApiClass.SubscribeType.SubscribeType_RTime);

注意事项

在使用TDX期货常规数据接口时，需要注意以下事项：

• 数据接口在使用前需要连接，在使用后需要断开连接。
• 实时行情数据更新频率较高，建议使用多线程处理。
• 历史数据需要指定时间范围，否则会返回全部历史数据。
• 订阅行情数据时，需要指定订阅类型，可以订阅实时行情或分时行情。
• 取消订阅后，不再接收行情数据的更新。