跳到主要内容

获取持仓模式

API说明​

此接口允许查询持仓持仓模式（逐仓或全仓）和持仓布局（合并或分开持仓），使用户能够有效管理其交易策略。

注意：持仓模式数据可通过RESTful和Websocket接口获取。本页是RESTful接口的描述。如需了解Websocket接口，请参见 跳转

注意事项​

无

认证​

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

请求方法​

GET

接口地址​

/v1/perpum/positions/type

频率限制​

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

请求参数​

无

响应参数​

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

请求示例​

以下Python代码展示了如何检查持仓布局和持仓持仓模式。

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

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