跳到主要内容

调整保证金

API说明​

此接口允许用户调整现有持仓（已成交订单）的保证金。通过指定持仓ID，用户可以增加或减少特定保证金金额。

注意：调整保证金仅通过RESTful API可用。

注意事项​

无

认证​

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

请求方法​

POST

接口地址​

/v1/perpum/positions/margin

频率限制​

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

请求参数​

参数必填类型描述
idtrueLong持仓ID
addMarginfalseBigdecimal要增加的保证金金额。注意：增加的保证金金额必须大于0。
reduceMarginfalseBigdecimal要减少的保证金金额。注意：减少的保证金金额必须大于0。
typefalseString指定余额查询范围。可能的值：all：包括余额和万能金；almightyGold：仅万能金；balance：仅余额。

响应参数​

参数类型描述
msgString成功

请求示例​

以下Python代码展示了如何为持仓增加保证金。

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

params = {
        "id": "2435521222632020221",
        "addMargin": 1,       
        # "reduceMargin": 1,            
        # "type": "all",        
        }
method = "POST"
api_url = "/v1/perpum/positions/margin"
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, 'msg': 'Success'}