跳到主要内容

获取杠杆信息

API说明​

此接口提供已成交（使用持仓ID检索）和未成交（使用订单ID检索）订单的杠杆详情。请注意，杠杆信息一次只能获取一个订单（已成交或未成交）。

注意：杠杆信息数据只能通过 RESTful API 获取。

注意事项​

无

认证​

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

请求方法​

GET

接口地址​

/v1/perpum/positions/leverage

频率限制​

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

请求参数​

参数必填类型描述
positionIdfalseLong查询已成交订单的杠杆时需要。
orderIdfalseLong查询未成交订单的杠杆时需要。

响应参数​

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

请求示例​

以下Python代码展示了如何使用订单ID获取未成交订单的杠杆。

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

params = {
        # "positionId" : "",
        "orderId" : "33308747742951172",
    }
 
api_url = "/v1/perpum/positions/leverage"
method = "GET"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)     # 函数FuturesRestfulPrivate()在章节(简介 > 认证和代码示例 > 合约 > RESTful私有接口)中定义

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

响应示例​

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

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