跳到主要内容

获取指定交易品种交易数据

API说明​

此接口允许查询指定交易品种交易数据，包括合约大小、方向、ID、时间戳和价格。默认情况下，它将返回最近20笔交易的数据。

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

注意事项​

  1. 此接口不允许用户指定要返回的交易数量。默认情况下，它将返回最近20笔交易。
  2. 此接口不支持在指定时间间隔内查询交易数据的时间范围。

认证​

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

请求方法​

GET

接口地址​

/v1/perpumPublic/trades

频率限制​

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

请求参数​

参数必填类型描述
basetrueString注意：USDT 合约只需传入基础货币名称，如 BTCUSDT 传 BTC 即可；USDC 合约请传完整交易对，如 BTC_USDC。此参数不区分大小写。
注意：对于以数字开头的交易品种（例如，1000PEPE），大写和小写格式均有效。

响应参数​

参数类型描述
createdDateLong交易时间戳
pieceString合约数量
directionString交易方向：做多(long)，做空(short)
priceString已执行的交易价格
quantityString交易量（币数量）
idLongID

请求示例​

以下Python代码展示了如何获取BTC的交易数据。

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

api_url = "/v1/perpumPublic/trades"
 
params = {"base": "BTC", }
FuturesRestfulPublic(api_url, params) # function FuturesRestfulPublic() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface)

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

响应示例​

以下是上述Python请求返回的示例响应。实际响应包含最近20笔交易的数据。为简洁起见，以下仅显示3笔交易：

{
{'code': 0,
 'data': [{'createdDate': 1744799567321,
   'direction': 'long',
   'id': 21320586404543493,
   'piece': '21',
   'price': '83902.9',
   'quantity': '0.021'},
  {'createdDate': 1744799566969,
   'direction': 'short',
   'id': 21320586350672903,
   'piece': '562',
   'price': '83906.7',
   'quantity': '0.562'},
  {'createdDate': 1744799566600,
   'direction': 'long',
   'id': 21320586307943429,
   'piece': '30',
   'price': '83908.5',
   'quantity': '0.03'}......],
 'msg': ''}
}