获取订单详请

API说明

此接口通过指定订单ID获取订单的详细信息。

注意：订单详请只能通过 RESTful API 可用。

注意事项

1. 此接口每个请求仅接受一个订单ID。不支持指定多个订单ID。
2. 此接口每个请求仅接受订单ID不超过7天的订单。

认证

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

请求方法

POST

接口地址

/api/v1/private?command=returnOrderTrades

频率限制

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

请求参数

参数	必填	类型	描述
orderNumber	True	String	订单ID

响应参数

参数	类型	描述
tradeID	Long	订单ID
currencyPair	String	交易品种，例如BTC_USDT
type	String	交易方向：buy/sell
amount	String	以报价货币计的当前订单大小
success_amount	String	以报价货币计的已交易订单大小
total	String	以基础货币计的当前订单大小
success_total	String	以基础货币计的已交易订单大小
fee	String	手续费
date	String	交易时间
status	Integer	状态：1：未完成，2：部分完成，3：完全完成，4：用户取消

请求示例

以下Python代码展示了如何获取订单详请。

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

api_url = "/api/v1/private?command=returnOrderTrades"
method = "POST"
params = {
            "orderNumber": "4624385377802383167"
        }
SpotRestuflPrivate(host, api_url, method, api_key, params, secret_key)  # 函数SpotRestuflPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

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

响应示例

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

{'code': '200',
 'data': {'tradeID': 4624385377802383167,
  'currencyPair': 'BTC_USDT',
  'type': 'buy',
  'amount': '0.00',
  'success_amount': '98.91',
  'total': '0.0000',
  'success_total': '0.0012',
  'fee': '0.00',
  'date': '2025-03-12 17:37:31',
  'status': 3},
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}