跳到主要内容

批量平仓

API说明​

此接口允许用户通过指定thirdOrderId（用户下单时定义的自定义ID）批量以市价平仓多个持仓。

注意：批量平仓仅通过RESTful API可用。

注意事项​

  1. 通常，平仓是通过在相反方向下达相同订单来完成的。但是，这种方法在CoinW上不适用。在相反方向下达订单将开设新仓位，而不是关闭原始仓位，导致两个活跃仓位。要正确平仓，请使用此专用接口。
  2. 此接口需要"thirdOrderId"来批量平仓。如果多个持仓共享相同的"thirdOrderId"，所有相应的持仓都将被平仓。
  3. 此接口仅支持以市价批量平仓，不允许用户指定平仓价格。要以特定价格平仓，请参考合约 > 下单 > 平仓。
  4. 在资金费用期间，不允许进行下单或平仓等交易操作。尝试这些操作将导致错误响应。 资金费用流程通常需要 30 至 40 秒。建议至少等待 1 分钟后再尝试交易操作。 具体的资金费用表，请参阅官方网页。
  5. 平台支持三种交易来源：用户自主下单、跟单系统下单、策略广场量化机器人下单，三类交易在持仓层面统一展示，不过 OpenAPI 仅支持对用户自主下单产生的仓位进行操作（如平仓、撤单等）。对于跟单及策略广场产生的仓位，API 无操作权限，相关操作建议使用平台内对应功能完成处理。

认证​

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

请求方法​

DELETE

接口地址​

/v1/perpum/batchClose

频率限制​

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

请求参数​

参数必填类型描述
thirdOrderIdtrueString自定义订单ID

响应参数​

参数类型描述
openIdLong订单ID
thirdOrderIdLong自定义订单ID
tsLong时间戳（毫秒）

请求示例​

以下Python代码展示了如何批量平仓。

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

params1 = { "thirdOrderId" : "111111111111", }
params2 = { "thirdOrderId" : "2222222222",}
params = [params1,params2]
 
api_url = "/v1/perpum/batchClose"
method = "DELETE"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)   # function FuturesRestfulPrivate() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface)

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

响应示例​

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

{'code': 0,
 'data': [
  {'msgCode': 0,'openId': '33308750244767807','thirdOrderId': '111111111111', 'ts': 1775443378356},
  {'msgCode': 0, 'openId': '33308750244776514', 'thirdOrderId': '2222222222', 'ts': 1775443378356}
],'msg': ''}