反向持仓
API说明
此接口允许用户即时反转现有永续合约持仓。通过指定持仓ID，系统将平仓当前持仓，并以相同持仓大小在相反方向（例如，从做多到做空或从做空到做多）开设新持仓。
注意：反向持仓仅通过RESTful API可用。
注意事项
- 持仓反转分两步进行：平仓现有持仓；在相反方向开设相同大小的新持仓。
- 反转后，持仓ID将发生变化。
- 平台支持三种交易来源：用户自主下单、跟单系统下单、策略广场量化机器人下单，三类交易在持仓层面统一展示，不过 OpenAPI 仅支持对用户自主下单产生的仓位进行操作（如平仓、撤单等）。对于跟单及策略广场产生的仓位，API 无操作权限，相关操作建议使用平台内对应功能完成处理。
认证
这是一个私有接口，需要认证。有关使用Restful API的详细信息，请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。
请求方法
POST
接口地址
频率限制
该接口的调用频率限制为：每个 IP 和用户 ID 每秒最多请求5次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转
请求参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| id | true | Long | 持仓ID |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| data | Long | 订单ID |
请求示例
以下Python代码展示了如何使用一键持仓反转。
注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。
params = { "id": "2435521222632013958"}
api_url = "/v1/perpum/positions/reverse"
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': {'value': '33308749862574458'}, 'msg': ''}