获取历史订单

API说明

此接口允许用户检索所有交易品种的历史订单。它支持通过特定交易品种进行可选过滤，每个请求最多返回100条记录。用户可以使用基于时间的过滤器或分页进一步细化结果，以实现高效的数据检索。

注意：历史订单数据只能通过 RESTful API 获取。

注意事项

每个请求最多返回100条记录。
市价单的"orderType"将返回为"LIMIT"。
未开始交易的订单将不会在此接口中显示，只会返回已经成交订单。

认证

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

请求方法

POST

接口地址

/api/v1/private?command=getUserTrades

频率限制

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

请求参数

参数	必填	类型	描述
symbol	False	String	交易品种，例如BTC_USDT
startAt	False	Long	开始时间（时间戳）
endAt	False	Long	结束时间（时间戳）
limit	False	Integer	查询数量：0 < limit <= 100
before	False	String	上一页的分页参数（如有）
after	False	String	下一页的分页参数（如有）

响应参数

参数	类型	描述
tradeId	Long	交易ID
orderId	Long	订单ID
price	string	以报价货币计的订单价格
size	String	以基础货币计的订单大小
side	String	交易方向：Buy/Sell
orderType	String	订单类型：Limit
time	Long	交易时间（时间戳）
fee	String	手续费
before	Long	上一页的分页参数（如有）
after	Long	下一页的分页参数（如有）

请求示例

以下Python代码展示了如何获取BTC_USDT的用户历史订单。

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

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

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

响应示例

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

{'code': '200',
 'data': {'list': [{'orderType': 'LIMIT',
    'orderId': 4624385377802383167,
    'fee': '0E-18',
    'price': '82429.080000000000000000',
    'size': '0.001200000000000000',
    'side': 'BUY',
    'time': 1741772251663,
    'tradeId': 127204554},.......]},
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}

API说明​

注意事项​

认证​

请求方法​

接口地址​

频率限制​

请求参数​

响应参数​

请求示例​

响应示例​