仓位管理 - 接口集合
<p>[TOC]</p>
<h1>获取持仓列表</h1>
<h2>接口描述</h2>
<ul>
<li>获取持仓列表</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/position/userPosition</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>是否必需</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>symbol</td>
<td>STRING</td>
<td>NO</td>
<td>交易对</td>
</tr>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code>{</code></pre>
<p> "code": "0",
"msg": "Success",
"data": [
{
"id": 7, //持仓ID
"userId": 841750104334766080, //用户ID
"symbolId": 1, //交易对ID
"symbol": "PERP_BTC_USDT", //交易对
"positionSide": "BOTH", //持仓方向[BOTH:多向持仓；LONG:多；SHORT:空]
"positionMode": true, //持仓模式[1:全仓cross 2:逐仓isolated]
"leverage": "100", //杠杆倍数
"positionSize": "-0.5", //持仓数量（根据持仓数量判断方向 负数：SELL，正数：BUY）
"entryPrice": "58000", //持仓价格
"notional": "29000", //持仓名义价值（USD）
"breakEvenPrice": "58000", //盈亏平衡价
"liquidationPrice": "30221.05263158",//强平价格
"realizedProfit": "0", //持仓已实现盈亏
"marginAsset": "USDT", //保证金币种
"isolatedMargin": "0", //逐仓保证金
"initialMargin": "290", //初始保证金
"maintenanceMargin": "145", //维持保证金
"maintenanceMarginRate": "0.005", //维持保证金率
"adl": 1, //自动减仓等级
"slPrice": "58000.05", //止损价格
"tpPrice": "58000.05", //止盈价格
"createTime": "2024-10-08T15:09:03", //创建时间
"updateTime": "2024-10-11T15:43:51" //更新时间
}
]
}</p>
<h1>合约平仓</h1>
<h2>接口描述</h2>
<ul>
<li>合约平仓</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>POST <code>/perp/contract/position/closePosition</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s</li>
</ul>
<h2>参数类型</h2>
<ul>
<li>Body Params</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">symbol</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">交易对</td>
</tr>
</tbody>
</table>
<ul>
<li>当symbol为空时，就撤销所有持仓（一键平仓）</li>
</ul>
<h3>返回参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">平仓状态</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code>{
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: true
}</code></pre>
<h1>设置仓位止盈止损价格</h1>
<h2>接口描述</h2>
<ul>
<li>设置仓位止盈止损价格</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>POST <code>/perp/contract/position/setPositionTPSLPrice</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s</li>
</ul>
<h2>参数类型</h2>
<ul>
<li>Body JSON</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">symbol</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">交易对</td>
</tr>
<tr>
<td style="text-align: left;">slPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">止损价格</td>
</tr>
<tr>
<td style="text-align: left;">tpPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">止盈价格</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>{
&quot;symbol&quot;: &quot;PERP_BTC_USDT&quot;,
&quot;slPrice&quot;: 97287.1,
&quot;tpPrice&quot;: 97287.1
}</code></pre>
<h3>返回参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">修改状态</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code>{
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: true
}</code></pre>