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

API说明

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

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

注意事项

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

认证

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

请求方法

GET

接口地址

/v1/perpumPublic/trades

频率限制

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

请求参数

参数	必填	类型	描述
base	true	String	交易品种的基础货币。（例如，BTC或btc）。此参数不区分大小写。 注意：对于以数字开头的交易品种（例如，1000PEPE），大写和小写格式均有效。

响应参数

参数	类型	描述
createdDate	Long	交易时间戳
piece	String	合约数量
direction	String	交易方向：做多(long)，做空(short)
price	String	已执行的交易价格
quantity	String	交易量（币数量）
id	Long	ID

请求示例

以下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': ''}
}