跳到主要内容

设置持仓模式

API说明​

此接口允许用户将其持仓持仓模式配置为逐仓或全仓，并通过选择合并持仓（合并相同方向的新持仓）或分开持仓（保持新持仓分离）来设置持仓布局。

注意：设置持仓模式只能通过 RESTful API 可用。

注意事项

  1. 要将持仓持仓模式从逐仓更改为全仓或反之，用户必须确保没有未成交订单。否则，接口将返回以下错误：
{'code': 9042, 'msg': 'You have an open order in this mode, please close or cancel it first.'}
  1. 要将持仓布局从合并持仓更改为分开持仓或反之，用户必须确保没有未成交订单。否则，接口也将返回上述错误。

认证​

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

请求方法​

POST

接口地址​

/v1/perpum/positions/type

频率限制​

此接口的频率限制为每用户ID和IP每2秒2个请求。

请求参数​

参数必填类型描述
positionModeltrueInteger持仓持仓模式：0：逐仓，1：全仓
layouttrueString持仓布局：0：合并持仓（相同方向的持仓将被合并），1：分开持仓（相同方向的持仓将保持分离）

响应参数​

参数类型描述
dataStringTRANSACTION_SUCCESS

请求示例​

以下Python代码展示了如何将持仓布局设置为合并(layout=0)和持仓持仓模式设置为逐仓(positionModel=0)。

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

params = {
        "layout": "0",   
        "positionModel": 0,
        }
 
api_url = "/v1/perpum/positions/type"
method = "POST"
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': 'TRANSACTION_SUCCESS', 'msg': ''}