账户成交历史 (USER_DATA)

接口描述

获取成交历史

HTTP请求

GET /dapi/v1/userTrades

请求权重

传symbol 20，不传pairs 40（迁移后：固定 5）

请求参数

名称	类型	是否必需	描述
symbol	STRING	NO	交易对
pair	STRING	NO	标的交易对
orderId	STRING	NO	订单号
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
fromId	LONG	NO	返回该fromId及之后的成交,缺省返回最近的成交,仅支持配合symbol使用
limit	INT	NO	返回的结果集数量 默认值:50 最大值:1000
recvWindow	LONG	NO
timestamp	LONG	YES

• symbol 或 pair 其中一个必传
• symbol 和 pair 不可同时提供
• fromId 和 pair 不可同时提供
• orderId必须和symbol一起提供
• 发送 pair的,返回pair对应所有正在交易的symbol数据
• 参数 fromId 不能和startTime 与 endTime一起发送
• 如果startTime 和 endTime 均未发送, 只会返回最近7天的数据。
• startTime 和 endTime 的最大间隔为7天

响应示例

[
	{
		'symbol': 'BTCUSD_200626',		// 交易对
	  	'id': 6,						// 交易ID
	  	'orderId': 28,					// 订单ID
	  	'pair': 'BTCUSD',				// 标的交易对
	  	'side': 'SELL',					// 买卖方向
	  	'price': '8800',				// 成交价
	  	'qty': '1',						// 成交量(张数)
	  	'realizedPnl': '0',				// 实现盈亏
	  	'marginAsset': 'BTC',			// 保证金币种
	  	'baseQty': '0.01136364',		// 成交额(标的数量)
	  	'commission': '0.00000454',	// 手续费
	  	'commissionAsset': 'BTC',		// 手续费单位
	  	'time': 1590743483586,			// 时间
	  	'positionSide': 'BOTH',			// 持仓方向
	  	'buyer': false,					// 是否是买方
	  	'maker': false					// 是否是挂单方
	}
]