← 返回接口目录

7709-心跳

作用

长连接保活请求。真实 socket 默认后台每 30 秒自动发送一次，也可以手动调用检查服务端响应。

项目	内容
调用方法	client.session.heartbeat()
底层接口	0x0004
返回模型	HeartbeatAck

示例

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    ack = client.session.heartbeat()
    print(ack.server_date)

关闭自动心跳：

client = TdxClient(heartbeat_interval=None)

参数

参数	含义
无	不需要业务参数

解析字段

HeartbeatAck 字段	含义
reserved	保留字节
server_date_raw	原始日期
server_date	解析后的日期
raw_payload	原始 payload

使用说明

项目	说明
自动保活	TdxClient() 默认 heartbeat_interval=30.0，真实 socket 后台保活
关闭保活	TdxClient(heartbeat_interval=None)
手动调用	client.session.heartbeat() 可用于检查连接是否还能正常收发
返回内容	主要是服务端日期和保留字段，不承载行情业务数据

真实返回样本

真实返回 JSON · HeartbeatResponse

采样主站广州云主站 Z25

采样日期2026-08-17

返回类型HeartbeatResponse

真实采样；心跳只确认连接和服务端日期，不包含行情字段。

{
  "reserved": "000000000000",
  "server_date_raw": 20260817,
  "server_date": "2026-08-17"
}