</>

期货实时快照通达信扩展行情

请求期货当前快照，返回最新价、结算价、成交量、成交额、持仓量和五档盘口等字段。

接口类型: 临时请求（HTTP POST，查一次返回一次）
调用路径: /v1/request/futures_realtime_snapshot_tdx
接口名称: futures_realtime_snapshot_tdx
Provider: axdata.source.tdx_ext_external
源: 通达信扩展行情 / tdx_ext
资产类型: future
插件状态: enabled
信任级别: official
采集支持: 否

请求期货当前快照，返回最新价、结算价、成交量、成交额、持仓量和五档盘口等字段。

输入参数

参数	类型	必填	说明	默认值
`code`	string	是	品种代码；可传单个、列表或英文逗号分隔字符串。
`tdx_root`	string	否	本机通达信目录（可选，高级）

参数说明

默认不用传 tdx_root；只有 API 服务器上的通达信安装目录不是常见位置，或想指定某个 hq_cache 目录时才需要传。

参数示例

# 期货快照
client.call("futures_realtime_snapshot_tdx", code="IC2607.CFFEX")

返回字段

字段	类型	说明
`instrument_id`	string	AxData 统一品种代码。
`symbol`	string	源端品种代码。
`exchange`	string	交易所或资产场所。
`name`	string	可确认时返回品种名称。
`trade_date`	date	行情日期。
`last_price`	number	最新价或最新值。
`pre_close`	number	昨收或上期值。
`pre_settlement`	number	昨结算；源端有值时返回。
`open`	number	开盘价或本期值。
`high`	number	最高价或本期高值。
`low`	number	最低价或本期低值。
`settlement`	number	结算价；源端有值时返回。
`average_price`	number	均价；源端有值时返回。
`volume`	integer	成交量，按源端行情口径返回。
`amount`	number	成交额；源端有值时返回。
`open_interest`	integer	持仓量；源端有值时返回。
`open_interest_change`	integer	持仓变化；源端有值时返回。
`inside_volume`	integer	内盘量；源端有值时返回。
`outside_volume`	integer	外盘量；源端有值时返回。
`bid1_price`	number	买一价；源端有值时返回。
`bid1_volume`	integer	买一量；源端有值时返回。
`ask1_price`	number	卖一价；源端有值时返回。
`ask1_volume`	integer	卖一量；源端有值时返回。
`bid2_price`	number	买二价；源端有值时返回。
`bid2_volume`	integer	买二量；源端有值时返回。
`ask2_price`	number	卖二价；源端有值时返回。
`ask2_volume`	integer	卖二量；源端有值时返回。
`bid3_price`	number	买三价；源端有值时返回。
`bid3_volume`	integer	买三量；源端有值时返回。
`ask3_price`	number	卖三价；源端有值时返回。
`ask3_volume`	integer	卖三量；源端有值时返回。
`bid4_price`	number	买四价；源端有值时返回。
`bid4_volume`	integer	买四量；源端有值时返回。
`ask4_price`	number	卖四价；源端有值时返回。
`ask4_volume`	integer	卖四量；源端有值时返回。
`bid5_price`	number	买五价；源端有值时返回。
`bid5_volume`	integer	买五量；源端有值时返回。
`ask5_price`	number	卖五价；源端有值时返回。
`ask5_volume`	integer	卖五量；源端有值时返回。

调用示例

Python SDK

import axdata as ax

client = ax.AxDataClient()
rows = client.call(
    "futures_realtime_snapshot_tdx",
    code='IC2607.CFFEX',
)

HTTP API

POST /v1/request/futures_realtime_snapshot_tdx
Content-Type: application/json

{
  "params": {
    "code": "IC2607.CFFEX"
  }
}

真实样例快照

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

请求参数

{
  "code": "IC2607.CFFEX"
}

响应样例

instrument_id	symbol	exchange	name	trade_date	last_price	pre_close	pre_settlement	open	high	low	settlement	average_price	volume	amount	open_interest	open_interest_change	inside_volume	outside_volume	bid1_price	bid1_volume	ask1_price	ask1_volume
IC2607.CFFEX	IC2607	CFFEX	中证	20260703	8688.799805	8670.200195	8670.200195	8671.200195	8805.0	8592.200195	8718.799805	8697.435547	45511	79166021632.0	60372	42173	23107	22404	8688.0	9	8693.799805	1

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