跳到主要内容

获取历史公开交易

API说明​

此接口允许查询指定交易品种的获取历史公开交易。

注意:历史公开交易数据只能通过 RESTful API 获取。

注意事项​

  1. 此接口提供公共市场信息，但仍需要认证。

认证​

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

请求方法​

GET

接口地址​

/v1/perpum/orders/trades

频率限制​

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

请求参数​

参数必填类型描述
instrumenttrueString注意：USDT 合约只需传入基础货币名称，如 BTCUSDT 传 BTC 即可；USDC 合约请传完整交易对，如 BTC_USDC。此参数不区分大小写。
注意：对于以数字开头的交易品种（例如，1000PEPE），大写和小写格式均有效。
pageFalseInteger当前页
pageSizeFalseInteger当前页数注意：1. 默认返回100笔交易。2. 返回的最大交易数最多为500。

响应参数​

参数类型描述
closedPieceinteger已平仓合约数量
createdDatelong交易时间（时间戳）
dealPriceBigDecimal以报价货币计的交易价格，例如usdt
directionstring交易方向（long、short）
idlong成交ID

请求示例​

以下Python代码展示了如何获取"BTC"的历史公开交易。

注意：完整代码示例请参考常规信息 > 认证和代码示例 > 合约 > RESTful私有接口。

api_url = "/v1/perpum/orders/trades"
method = "GET"
params = { "instrument" : "BTC",
            # "page" :
            "pageSize" : 5, 
         }
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key) # 函数FuturesRestfulPrivate()在章节(简介 > 认证和代码示例 > 合约 > RESTful私有接口)中定义

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

响应示例​

以下是上述Python请求返回的响应：

{'code': 0,
 'data': {'nextId': 0,
  'prevId': 0,
  'rows': [{'closedPiece': 0,
    'createdDate': 1745221207000,
    'dealPrice': 0,
    'direction': 'short',
    'id': 21375851492523014},
   {'closedPiece': 0,
    'createdDate': 1745221207000,
    'dealPrice': 87479.8,
    'direction': 'long',
    'id': 21375851492523013},
   {'closedPiece': 0,
    'createdDate': 1745221206000,
    'dealPrice': 87479.8,
    'direction': 'long',
    'id': 21375851481381894},
   {'closedPiece': 0,
    'createdDate': 1745221206000,
    'dealPrice': 0,
    'direction': 'short',
    'id': 21375851481381893},
   {'closedPiece': 0,
    'createdDate': 1745221206000,
    'dealPrice': 87479.8,
    'direction': 'long',
    'id': 21375851453594630}],
  'total': 2883165},
 'msg': ''}