获取批量历史订单

API 说明

此接口支持通过以逗号分隔的字符串传入多个订单 ID，从而一次性查询多笔历史订单信息。返回结果将包含每个订单的详细数据，包括订单状态、委托数量、订单类型等内容。

注意： 本接口数据仅支持通过 RESTful API 获取

注意事项

1. 此接口暂不支持按特定交易品种进行筛选。
2. 该接口仅提供近三个月内的历史订单数据。
3. 未认证用户，或不在近三个月时间范围内的订单数据，将不会被返回。

身份验证

此为私有接口，需进行身份验证。有关 RESTful API 的使用详情，请参阅 简介 > 认证和代码示例 > 现货 > RESTful私有接口

请求方式

POST

请求路径

/v1/private?command=getBatchHistoryOrders

频率限制

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

请求参数

参数	必填	类型	描述
orderIds	True	String	待查询的订单 ID 字符串列表。 示例："1234567890","1234567891" 注意：每次请求最多支持 50 个订单 ID。

响应参数

参数	类型	描述
data	Object	主要响应数据对象。
-orderId	Integer	Order ID
-date	String	订单创建时间
-side	String	BUY/SELL
-type	String	订单类型 （限价单-LIMIT；市价单-MARKET；高级限价单-HL_LIMIT；计划委托单-PLANNING；止盈止损单-STOP_LIMIT_ORDER；智能市价单-SMART_MARKET_ORDER；冰山委托单-ICEBERG
-dealSize	String	以基础货币计的交易规模
-dealFunds	String	以报价货币计的交易规模
-dealAvgPrice	String	交易价格
-fee	String	交易费
-size	String	以基础货币计价的订单规模
-price	String	用户指定的下单价格（限价单）
-status	Integer	订单状态 1：未完成，2：部分完成，3：完全完成，4：用户取消 5：已触发 6 触发失败
-symbol	String	交易品种 (e.g., BTC_USDT).
msg	String	"SUCCESS"
failed	Boolean	true/false
success	Boolean	true/false

请求示例

以下Python代码展示了如何获取批量历史订单。

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

api_url = "/v1/private?command=getBatchHistoryOrders"
method = "post"
params ={"orderIds": "4626801005395149868,4626631680021608676,4626898861317523478,4624375482218447670" }
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key)  # 函数SpotRestuflPrivate()在章节 (简介 > 认证和代码示例 > 现货 > RESTful私有接口)

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

响应示例

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

{'code': '200',
 'data': [{'orderId': 4626631680021608676,
   'date': '2025-10-16 16:19:52',
   'side': 'SELL',
   'type': 'MARKET',
   'dealSize': '0.0009',
   'dealFunds': '99.61485',
   'dealAvgPrice': '110683.17',
   'fee': '0',
   'size': '0.0009',
   'price': '0',
   'status': 3,
   'symbol': 'BTC_USDT'},
  {'orderId': 4626898861317523478,
   'date': '2025-11-11 21:55:22',
   'side': 'BUY',
   'type': 'LIMIT',
   'dealSize': '0.0009',
   'dealFunds': '93.96',
   'dealAvgPrice': '1.044E+5',
   'fee': '0',
   'size': '0.0009',
   'price': '1.044E+5',
   'status': 3,
   'symbol': 'BTC_USDT'},
  {'orderId': 4626801005395149868,
   'date': '2025-11-06 22:07:45',
   'side': 'BUY',
   'type': 'MARKET',
   'dealSize': '0.0009',
   'dealFunds': '92.64926',
   'dealAvgPrice': '102943.62',
   'fee': '0',
   'size': '0',
   'price': '0',
   'status': 3,
   'symbol': 'BTC_USDT'}],
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}