跳到主要内容

获取持仓保证金率

API说明​

此接口允许通过指定持仓ID查询应用于持仓（已成交订单）的保证金率。

注意：持仓保证金率数据只能通过 RESTful API 获取。

注意事项​

  1. 查询逐仓保证金持仓的保证金率时，请求参数"positionId"是必需的。对于全仓保证金持仓，应省略此参数。

认证​

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

请求方法​

GET

接口地址​

/v1/perpum/positions/marginRate

频率限制​

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

请求参数​

参数必填类型描述
positionIdFalseLong持仓ID 注意：查询逐仓持仓的保证金率时，此参数是必需的。对于全仓保证金持仓，应省略此参数。

响应参数​

参数类型描述
dataBigDecimal持仓保证金率
data.tsLong时间戳（毫秒）

请求示例​

以下Python代码展示了如何获取逐仓保证金持仓的保证金率。

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

params = {
        "positionId" : 2435521222631980800
    }
api_url = "/v1/perpum/positions/marginRate"
method = "GET"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)   # function FuturesRestfulPrivatee() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface)

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

响应示例​

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

{'code': 0, 'data': {'value': 277.88745437, 'ts': 1775443378356}, 'msg': ''}