</>

ETFK线通达信

获取 ETF K 线，包含 OHLC、成交量额。

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

ETF K 线和指数 K 线使用同一套报文结构，上涨家数和下跌家数对 ETF 通常为空。

输入参数

参数	类型	必填	说明	默认值
`code`	string	是	ETF 代码：支持 510050.SH、159915.SZ、sh510050；批量可传列表或英文逗号分隔。
`period`	string	否	K线周期：day、week、month、quarter、year、1m、5m、15m、30m、60m；默认 day。	"day"
`count`	integer	否	返回条数，默认 120，适合源端直取预览；需要更长历史时显式传 count。	120

参数示例

# 日K
client.call("etf_kline_tdx", code="510050.SH", period="day", count=800)

# 5分钟K
client.call("etf_kline_tdx", code="510050.SH", period="5m", count=300)

返回字段

字段	类型	说明
`instrument_id`	string	AxData 统一指数代码，例如 000001.SH。
`symbol`	string	交易所原始六位指数代码。
`tdx_code`	string	TDX 带市场前缀代码，例如 sh000001。
`exchange`	string	AxData 交易所代码：SSE、SZSE 或 BSE。
`trade_time`	datetime	K 线时间。
`period`	string	K 线周期。
`open`	number	开盘点位。
`high`	number	最高点位。
`low`	number	最低点位。
`close`	number	收盘点位。
`volume`	number	指数 K 线成交量。
`amount`	number	指数 K 线成交额，单位：元。
`up_count`	integer	上涨家数。
`down_count`	integer	下跌家数。

调用示例

Python SDK

import axdata as ax

client = ax.AxDataClient()
rows = client.call(
    "etf_kline_tdx",
    code='510050.SH',
    count=3,
    period='day',
)

HTTP API

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

{
  "params": {
    "code": "510050.SH",
    "period": "day",
    "count": 3
  }
}

真实样例快照

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

请求参数

{
  "code": "510050.SH",
  "period": "day",
  "count": 3
}

响应样例

instrument_id	symbol	tdx_code	exchange	trade_time	period	open	high	low	close	volume	amount	up_count	down_count
510050.SH	510050	sh510050	SSE	2026-06-16T15:00:00+08:00	day	3.005	3.028	2.998	3.012	1356420.0	408234240.0
510050.SH	510050	sh510050	SSE	2026-06-17T15:00:00+08:00	day	3.01	3.035	3.006	3.025	1284560.0	388234240.0

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