</>

实时增量行情通达信

通过本地 SDK stream 或远程 WebSocket 订阅股票实时增量行情；本地 Python 不需要启动 API 后端。

接口类型: 实时流（本地 SDK stream 或远程 WebSocket，持续推送）
调用路径: /v1/stream/stock_quote_refresh_tdx
接口名称: stock_quote_refresh_tdx
Provider: axdata.source.tdx_external
源: 通达信 / tdx
资产类型: stock
插件状态: enabled
信任级别: official
采集支持: 否

这个接口用于持续接收关注股票的最新行情变化。订阅建立后先返回一批当前快照，之后推送有变化标的的最新状态；没有变化时 data 为空。它不是普通一次性请求，也不会默认写入本地数据。

输入参数

参数	类型	必填	说明
`code`	string/list	是	证券代码：支持 000001.SZ、600000.SH；批量传数组，单次最多 100 只
`fields`	string/list	否	可选返回字段；不传时返回默认实时行情字段
`interval_ms`	integer	否	刷新间隔，默认 3000 毫秒，最小 500 毫秒
`initial_snapshot`	boolean	否	订阅后是否先返回当前快照，默认 true

参数说明

这是实时流接口，不是普通 HTTP 一次性请求；本地 SDK stream 不需要启动 API 后端。

参数示例

client.stream("stock_quote_refresh_tdx", code=["000001.SZ", "600000.SH"], interval_ms=3000)

返回字段

字段	类型	说明
`stream`	string	固定为 stock_quote_refresh_tdx
`type`	string	消息类型：subscribed、snapshot、update、heartbeat、status 或 error
`subscription_id`	string	订阅编号
`data`	array	行情数据数组；无变化时为空数组
`instrument_id`	string	AxData 统一证券代码，例如 000001.SZ
`last_price`	number	最新价
`change_pct`	number	涨跌幅，百分比数值
`volume`	number	成交量
`amount`	number	成交额

调用示例

Python SDK Stream

import axdata as ax

client = ax.AxDataClient()

with client.stream(
    "stock_quote_refresh_tdx",
    code=['000001.SZ', '600000.SH'],
    fields=['instrument_id', 'last_price', 'change_pct', 'volume', 'amount'],
    interval_ms=3000,
) as stream:
    for event in stream:
        print(event.type, event.data)

WebSocket

ws://127.0.0.1:8666/v1/stream/stock_quote_refresh_tdx

# 连接后发送订阅消息
{
  "op": "subscribe",
  "params": {
    "code": [
      "000001.SZ",
      "600000.SH"
    ],
    "fields": [
      "instrument_id",
      "last_price",
      "change_pct",
      "volume",
      "amount"
    ],
    "interval_ms": 3000,
    "initial_snapshot": true
  }
}

真实样例快照

展示插件接口目录里的固定 example.response，页面打开不会再次请求源端。

请求参数

{
  "code": [
    "000001.SZ",
    "600000.SH"
  ],
  "fields": [
    "instrument_id",
    "last_price",
    "change_pct",
    "volume",
    "amount"
  ],
  "interval_ms": 3000,
  "initial_snapshot": true
}

响应样例

type	stream	subscription_id	data
snapshot	stock_quote_refresh_tdx	sub_xxx	[{"instrument_id":"000001.SZ","last_price":10.14,"change_pct":-1.36,"volume":1000,"amount":1014000}]

参考表

消息类型

客户端按 type 判断消息用途；行情行放在 data 里。

type	含义	说明
subscribed	订阅确认	服务端确认订阅参数和订阅编号
snapshot	初始快照	订阅建立后返回当前最新行情
update	增量更新	后续只推送有变化的标的最新状态
heartbeat	心跳响应	客户端发送 ping 或 heartbeat 时返回
status	状态变化	取消订阅、关闭等状态
error	错误	参数错误、源端不可用或权限问题

生成时间：2026-07-06T16:54:55+00:00