跳到主要内容

获取成交记录

API说明​

此接口返回指定交易品种的成交记录。

注意：成交记录只能通过 RESTful API 获取。

注意事项​

  1. 此接口不会返回尚未执行订单的交易历史记录，仅返回已完成的订单。
  2. 此接口仅返回最近 30 天内的交易记录。

认证​

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

请求方法​

POST

接口地址​

/api/v1/private?command=returnUTradeHistory

频率限制​

该接口的调用频率限制为：每个用户 ID 每2秒最多请求5次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数​

参数必填类型描述
currencyPairTrueString交易对品种。可同时输入多个交易对，需使用逗号进行分隔。
示例："BTC_USDT,ETH_USDT"
注意：每次请求最多可输入 20 个交易对
startAtFalseString开始时间（时间戳）
endAtFalseString结束时间（时间戳）

响应参数​

参数类型描述
tradeIDString交易ID
typeString交易方向：Buy/Sell
amountString以报价货币计的当前订单大小
success_amountString以报价货币计的已交易订单大小
totalString以基础货币计的当前订单大小
success_countString以基础货币计的已交易订单大小
feeString手续费
prizeString用户指定的订单价格
dateString交易时间（时间戳）
statusString状态：1：未完成，2：部分完成，3：完全完成，4：用户取消
pairString交易对品种

请求示例​

以下Python代码展示了如何获取BTC_USDT和ETH_USDT的成交记录。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

api_url = "/api/v1/private?command=returnUTradeHistory"
method = "post"
params = {"currencyPair": "BTC_USDT,ETH_USDT",
          #"startAt":"1631526172583",
          #"endAt":"1631526317779"
         }
SpotRestuflPrivate(host, api_url, method, api_key, params, secret_key)  # 函数SpotRestuflPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

响应示例​

以下是上述Python请求返回的示例响应。为简洁起见，下面仅显示二个订单:

{'code': '200',
 'data': [{'tradeID': 4626945040880301545,
   'date': 1764334890420,
   'amount': '0.00',
   'total': '0.0000',
   'fee': '0.00',
   'type': 'buy',
   'prize': '0.00',
   'success_count': '0.0010',
   'success_amount': '91.57',
   'status': 3,
   'out_trade_no': '',
   'pair': 'BTC_USDT'},
  {'tradeID': 4626942841857038261,
   'date': 1764334912854,
   'amount': '0.00',
   'total': '0.0000',
   'fee': '0.00',
   'type': 'buy',
   'prize': '0.00',
   'success_count': '0.0493',
   'success_amount': '149.73',
   'status': 3,
   'out_trade_no': '',
   'pair': 'ETH_USDT'}],
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}