</>

期货K线通达信扩展行情

请求期货K线，返回OHLC、成交量、持仓量和结算价。

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

请求期货K线，返回OHLC、成交量、持仓量和结算价。

输入参数

参数	类型	必填	说明	默认值
`code`	string	是	品种代码；可传单个、列表或英文逗号分隔字符串。
`period`	string	否	K线周期：1m、5m、15m、30m、60m、day、week、month、quarter、year；默认 day。	"day"
`limit`	integer	否	每个品种返回前多少根，默认 30。	30
`tdx_root`	string	否	本机通达信目录（可选，高级）

参数说明

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

参数示例

# 期货日K
client.call("futures_kline_tdx", code="IC2607.CFFEX", period="day", limit=3)

返回字段

字段	类型	说明
`instrument_id`	string	AxData 统一品种代码。
`symbol`	string	源端品种代码。
`exchange`	string	交易所或资产场所。
`name`	string	可确认时返回品种名称。
`trade_time`	date	K线日期或时间。
`period`	string	K线周期。
`open`	number	开盘价或本期值。
`high`	number	最高价或本期高值。
`low`	number	最低价或本期低值。
`close`	number	收盘价或本期值。
`volume`	integer	K线成交量，按源端周期口径返回。
`open_interest`	integer	持仓量；源端有值时返回。
`settlement`	number	结算价；源端有值时返回。

调用示例

Python SDK

import axdata as ax

client = ax.AxDataClient()
rows = client.call(
    "futures_kline_tdx",
    code='IC2607.CFFEX',
    limit=3,
    period='day',
)

HTTP API

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

{
  "params": {
    "code": "IC2607.CFFEX",
    "period": "day",
    "limit": 3
  }
}

真实样例快照

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

请求参数

{
  "code": "IC2607.CFFEX",
  "period": "day",
  "limit": 3
}

响应样例

instrument_id	symbol	exchange	name	trade_time	period	open	high	low	close	volume	open_interest	settlement
IC2607.CFFEX	IC2607	CFFEX	中证	20260703	day	8671.200195	8805.0	8592.200195	8688.799805	45511	60372	8718.799805

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