</>

外汇历史逐笔通达信扩展行情

请求指定日期外汇逐笔明细。外汇样本可能没有成交量和开平类型，按源端真实值返回。

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

请求指定日期外汇逐笔明细。外汇样本可能没有成交量和开平类型，按源端真实值返回。

输入参数

参数	类型	必填	说明	默认值
`code`	string	是	品种代码；可传单个、列表或英文逗号分隔字符串。
`trade_date`	date	是	交易日期，YYYYMMDD 或 YYYY-MM-DD。
`limit`	integer	否	每个品种返回多少笔，默认返回最新一页的 120 笔；all=true 时作为总数量上限。	120
`all`	boolean	否	是否自动翻页取完整逐笔，并按时间顺序返回；默认 false。	false
`page_size`	integer	否	all=true 时每页请求笔数，默认 1800。	1800
`tdx_root`	string	否	本机通达信目录（可选，高级）

参数说明

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

参数示例

# 外汇历史逐笔
client.call("fx_trades_history_tdx", code="USDCNY.FX", trade_date="20260618", limit=3)

返回字段

字段	类型	说明
`instrument_id`	string	AxData 统一品种代码。
`symbol`	string	源端品种代码。
`exchange`	string	交易所或资产场所。
`name`	string	可确认时返回品种名称。
`trade_date`	date	交易日期。
`time_label`	string	成交时间，精确到秒。
`price`	number	成交价。
`volume`	integer	成交量，按源端逐笔口径返回。
`position_change`	integer	仓差；源端有值时返回。
`open_close_type`	string	开平类型；可确认时返回，如双开、双平、多开、空开、多平、空平、多换、空换、换手。

调用示例

Python SDK

import axdata as ax

client = ax.AxDataClient()
rows = client.call(
    "fx_trades_history_tdx",
    code='USDCNY.FX',
    limit=3,
    trade_date='20260618',
)

HTTP API

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

{
  "params": {
    "code": "USDCNY.FX",
    "trade_date": "20260618",
    "limit": 3
  }
}

真实样例快照

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

请求参数

{
  "code": "USDCNY.FX",
  "trade_date": "20260618",
  "limit": 3
}

响应样例

instrument_id	symbol	exchange	name	trade_date	time_label	price	volume	position_change	open_close_type
USDCNY.FX	USDCNY	FX		20260618	00:42:02	6.7658	0	0
USDCNY.FX	USDCNY	FX		20260618	00:52:02	6.7671	0	0

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