跳到主要内容

获取最近成交

API说明​

此接口允许查询指定交易品种的最近成交数据，包括成交数量、成交价格、总成交金额、成交时间、成交方向和成交记录ID。

注意：最近成交数据可通过RESTful和Websocket接口获取。本页是RESTful接口的描述。如需了解Websocket接口，请参见 跳转

注意事项​

  1. 如果未指定时间戳，接口将返回指定每个交易品种的最后50笔成交。
  2. 如果提供了开始或结束时间戳，返回的成交数据将限制为最多50条记录。

认证​

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

请求方法​

GET

接口地址​

/api/v1/public?command=returnTradeHistory

频率限制​

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

请求参数​

参数必填类型描述
symbolTrueString交易对。允许输入多个交易对，以逗号分隔。
示例："BTC_USDT,ETH_USDT"
注意：每次请求最多可输入 20 个交易对
startFalseString开始时间：UNIX时间戳
endFalseString结束时间：UNIX时间戳

响应参数​

参数类型描述
idString成交记录ID
typeString成交方向：Buy/Sell
priceString以报价货币计的价格
amountString以基础货币计的成交量
totalString以报价货币计的成交量
timeString成交时间（时间戳）
pairString交易品种

请求示例​

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

注意：完整代码示例请参考公共 > 认证和代码示例 > 现货 > RESTful公共接口。

api_url= "/api/v1/public?command=returnTradeHistory"
params={
    "symbol": "BTC_USDT,ETH_USDT",   
    # "start": "1579238517000", 
    # "end": "1581916917660",
       }
SpotRestfulPublic(api_url, params)  # 函数SpotRestfulPublic()在章节(公共 > 认证和代码示例 > 现货 > RESTful公共接口)中定义

注意：完整Java代码请参考公共 > 认证和代码示例 > 现货 > RESTful公共接口。

响应示例​

以下是上述Python请求返回的示例响应。实际响应每交易品种最近50笔成交的数据。为简洁起见，以下每个品种仅显示四笔交易：

{'code': '200',
 'data': [{'id': 142912092,    ## BTC_USDT
   'type': 'SELL',
   'price': '87468.02',
   'amount': '0.0007',
   'total': '61.227614',
   'time': '2025-11-25 21:01:25',
   'pair': 'BTC_USDT'},
  {'id': 142912091,
   'type': 'SELL',
   'price': '87468.12',
   'amount': '0.0009',
   'total': '78.721308',
   'time': '2025-11-25 21:01:24',
   'pair': 'BTC_USDT'},
  {'id': 142912090,
   'type': 'BUY',
   'price': '87467.74',
   'amount': '0.8241',
   'total': '72082.164534',
   'time': '2025-11-25 21:01:23',
   'pair': 'BTC_USDT'},,........
  {'id': 142912043,
   'type': 'SELL',
   'price': '87499.97',
   'amount': '0.0011',
   'total': '96.249967',
   'time': '2025-11-25 20:59:38',
   'pair': 'BTC_USDT'},
  {'id': 67594437,              # ETH_USDT
   'type': 'SELL',
   'price': '2925.75',
   'amount': '0.2533',
   'total': '741.092475',
   'time': '2025-11-25 21:01:19',
   'pair': 'ETH_USDT'},
  {'id': 67594436,
   'type': 'SELL',
   'price': '2925.7',
   'amount': '0.146',
   'total': '427.1522',
   'time': '2025-11-25 21:01:18',
   'pair': 'ETH_USDT'},
  {'id': 67594435,
   'type': 'SELL',
   'price': '2925.55',
   'amount': '0.1274',
   'total': '372.71507',
   'time': '2025-11-25 21:01:13',
   'pair': 'ETH_USDT'},.......
  {'id': 67594388,
   'type': 'SELL',
   'price': '2927.51',
   'amount': '0.1521',
   'total': '445.274271',
   'time': '2025-11-25 20:59:16',
   'pair': 'ETH_USDT'}],
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}