获取历史持仓列表
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>获取历史持仓列表</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/swap/order/history</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET
<h5>参数</h5></li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">openType</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">src</td>
<td>开仓类型 0市价1限价2计划3合并委托 多个条件[0,1]</td>
</tr>
<tr>
<td style="text-align: left;">closeType</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">src</td>
<td>平仓类型 4止盈止损</td>
</tr>
<tr>
<td style="text-align: left;">position</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">src</td>
<td>仓位id</td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">src</td>
<td>开始时间 yyyy-MM-dd</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">src</td>
<td>结束时间 yyyy-MM-dd</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<p><code> http://127.0.0.1:6012/swap/order/history?position=176618&amp;startTime=1990-01-01 </code></p>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;content&quot;: [
{
&quot;id&quot;: 1385479,
&quot;contractId&quot;: 1,
&quot;memberId&quot;: 804894,
&quot;positionId&quot;: 176618,
&quot;contractOrderEntrustId&quot;: &quot;CE171568128937775&quot;,
&quot;patterns&quot;: &quot;CROSSED&quot;,
&quot;entrustType&quot;: &quot;CLOSE&quot;,
&quot;direction&quot;: &quot;SELL&quot;,
&quot;type&quot;: &quot;MARKET_PRICE&quot;,
&quot;symbol&quot;: &quot;BTC/USDT&quot;,
&quot;coinSymbol&quot;: &quot;BTC&quot;,
&quot;baseSymbol&quot;: &quot;USDT&quot;,
&quot;triggerPrice&quot;: 0E-8,
&quot;entrustPrice&quot;: null,
&quot;lossPrice&quot;: null,
&quot;lossEntrustPrice&quot;: null,
&quot;profitPrice&quot;: null,
&quot;profitEntrustPrice&quot;: null,
&quot;tradedPrice&quot;: 30878.83526656,
&quot;principalUnit&quot;: &quot;USDT&quot;,
&quot;principalAmount&quot;: 308.78835267,
&quot;currentPrice&quot;: 61765.70000000,
&quot;openFee&quot;: null,
&quot;closeFee&quot;: 15.43941763,
&quot;shareNumber&quot;: 500.00000000,
&quot;volume&quot;: 1.00000000,
&quot;tradedVolume&quot;: 1.00000000,
&quot;profitAndLoss&quot;: -599.09972770,
&quot;status&quot;: &quot;ENTRUST_SUCCESS&quot;,
&quot;createTime&quot;: 1715681289377,
&quot;triggeringTime&quot;: 0,
&quot;isFromSpot&quot;: 0,
&quot;isBlast&quot;: 0,
&quot;isReward&quot;: 1,
&quot;isCut&quot;: 0,
&quot;isOneClose&quot;: 0,
&quot;isMarketAllClose&quot;: 0,
&quot;isLimitPrice&quot;: 0,
&quot;usdtOpenTime&quot;: 1713429372000,
&quot;usdtOpenPrice&quot;: 61453.91453300,
&quot;isReversedOpen&quot;: 0,
&quot;leverage&quot;: 100,
&quot;dealTime&quot;: 1715681289685,
&quot;positionType&quot;: 0,
&quot;moneyType&quot;: 1,
&quot;openType&quot;: 0,
&quot;closeType&quot;: 0,
&quot;decimalScale&quot;: 2,
&quot;isPercentage&quot;: null,
&quot;violateTime&quot;: null,
&quot;followId&quot;: null,
&quot;followSystemId&quot;: null,
&quot;dividendPercent&quot;: null,
&quot;isSpecial&quot;: null,
&quot;percentageVolume&quot;: null,
&quot;cutType&quot;: null,
&quot;cutMold&quot;: null,
&quot;followMemberId&quot;: null,
&quot;isSpotLimitOrder&quot;: 0,
&quot;isSpotLimitOrderMsg&quot;: null
}
],
&quot;totalElements&quot;: 1,
&quot;totalPages&quot;: 1,
&quot;last&quot;: true,
&quot;sort&quot;: [
{
&quot;direction&quot;: &quot;DESC&quot;,
&quot;property&quot;: &quot;createTime&quot;,
&quot;ignoreCase&quot;: false,
&quot;nullHandling&quot;: &quot;NATIVE&quot;,
&quot;ascending&quot;: false,
&quot;descending&quot;: true
}
],
&quot;first&quot;: true,
&quot;numberOfElements&quot;: 1,
&quot;number&quot;: 0,
&quot;size&quot;: 10
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">currentPositionWithCutList</td>
<td style="text-align: left;">list</td>
<td>当前持仓集合</td>
</tr>
<tr>
<td style="text-align: left;">memberId</td>
<td style="text-align: left;">int</td>
<td>用户id</td>
</tr>
<tr>
<td style="text-align: left;">leverage</td>
<td style="text-align: left;">int</td>
<td>杠杆</td>
</tr>
<tr>
<td style="text-align: left;">totalPosition</td>
<td style="text-align: left;">double</td>
<td>总仓位</td>
</tr>
<tr>
<td style="text-align: left;">openPrice</td>
<td style="text-align: left;">double</td>
<td>开仓价格</td>
</tr>
<tr>
<td style="text-align: left;">closedOpenPrice</td>
<td style="text-align: left;">double</td>
<td>已平仓部分开仓价格</td>
</tr>
<tr>
<td style="text-align: left;">closePrice</td>
<td style="text-align: left;">double</td>
<td>平仓价格</td>
</tr>
<tr>
<td style="text-align: left;">principalAmount</td>
<td style="text-align: left;">double</td>
<td>保证金</td>
</tr>
<tr>
<td style="text-align: left;">totalPrincipalAmount</td>
<td style="text-align: left;">double</td>
<td>总保证金</td>
</tr>
<tr>
<td style="text-align: left;">frozenPosition</td>
<td style="text-align: left;">double</td>
<td>冻结仓位</td>
</tr>
<tr>
<td style="text-align: left;">closedPosition</td>
<td style="text-align: left;">double</td>
<td>已平仓仓位</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>仓位类型 0 INTEGRAL合仓 1 SEPARATE分仓</td>
</tr>
<tr>
<td style="text-align: left;">moneyType</td>
<td style="text-align: left;">int</td>
<td>资金类型 0 USDT U本位 1 COIN币</td>
</tr>
<tr>
<td style="text-align: left;">direction</td>
<td style="text-align: left;">int</td>
<td>仓位方向 0 BUY多 1 SELL空</td>
</tr>
<tr>
<td style="text-align: left;">usdtProfit</td>
<td style="text-align: left;">double</td>
<td>已平仓仓位收益</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态 0 STARTED未平仓 1 PARTLYDONE部分平仓 2 DONE全部平仓</td>
</tr>
<tr>
<td style="text-align: left;">openTime</td>
<td style="text-align: left;">date</td>
<td>开仓时间</td>
</tr>
<tr>
<td style="text-align: left;">latestOpenTime</td>
<td style="text-align: left;">date</td>
<td>最近开仓时间</td>
</tr>
<tr>
<td style="text-align: left;">closeTime</td>
<td style="text-align: left;">date</td>
<td>平仓时间</td>
</tr>
<tr>
<td style="text-align: left;">openType</td>
<td style="text-align: left;">int</td>
<td>开仓类型 0市价委托 1限价委托 2计划委托</td>
</tr>
<tr>
<td style="text-align: left;">closeType</td>
<td style="text-align: left;">int</td>
<td>平仓类型 CLOSE平仓 MARKET_CLOSE市价全平 ONE_KEY_CLOSE一键平仓 REVERSE_OPEN反向开仓 CUT止盈止损 BLAST爆仓 ADMIN_CLOSE管理员强平</td>
</tr>
<tr>
<td style="text-align: left;">decimalScale</td>
<td style="text-align: left;">int</td>
<td>委托数量精度 客户端使用此精度限制小数位</td>
</tr>
<tr>
<td style="text-align: left;">commissionFee</td>
<td style="text-align: left;">double</td>
<td>手续费</td>
</tr>
<tr>
<td style="text-align: left;">currentPrice</td>
<td style="text-align: left;">double</td>
<td>当前价格</td>
</tr>
<tr>
<td style="text-align: left;">currentPosition</td>
<td style="text-align: left;">double</td>
<td>当前仓位</td>
</tr>
<tr>
<td style="text-align: left;">availablePosition</td>
<td style="text-align: left;">double</td>
<td>当前可用仓位</td>
</tr>
<tr>
<td style="text-align: left;">currentProfit</td>
<td style="text-align: left;">double</td>
<td>当前盈利</td>
</tr>
<tr>
<td style="text-align: left;">currentOpenValuec</td>
<td style="text-align: left;">double</td>
<td>当前仓位开仓金额</td>
</tr>
<tr>
<td style="text-align: left;">currentMarketValue</td>
<td style="text-align: left;">double</td>
<td>当前仓位市值</td>
</tr>
<tr>
<td style="text-align: left;">currentMargin</td>
<td style="text-align: left;">double</td>
<td>当前仓位保证金</td>
</tr>
<tr>
<td style="text-align: left;">estimatedBlastPrice</td>
<td style="text-align: left;">double</td>
<td>预估强平价</td>
</tr>
<tr>
<td style="text-align: left;">marginRate</td>
<td style="text-align: left;">double</td>
<td>保证金率</td>
</tr>
<tr>
<td style="text-align: left;">currencyBalance</td>
<td style="text-align: left;">double</td>
<td>资产账户金额</td>
</tr>
<tr>
<td style="text-align: left;">contractBalance</td>
<td style="text-align: left;">double</td>
<td>合约账户金额</td>
</tr>
<tr>
<td style="text-align: left;">followCount</td>
<td style="text-align: left;">int</td>
<td>当前跟单人数</td>
</tr>
<tr>
<td style="text-align: left;">cutList</td>
<td style="text-align: left;">list</td>
<td>止盈止损列表</td>
</tr>
<tr>
<td style="text-align: left;">contractId</td>
<td style="text-align: left;">int</td>
<td>合约ID</td>
</tr>
<tr>
<td style="text-align: left;">positionId</td>
<td style="text-align: left;">int</td>
<td>仓位id</td>
</tr>
<tr>
<td style="text-align: left;">contractOrderEntrustId</td>
<td style="text-align: left;">String</td>
<td>合约委托订单ID</td>
</tr>
<tr>
<td style="text-align: left;">patterns</td>
<td style="text-align: left;">int</td>
<td>0 全仓 1逐仓</td>
</tr>
<tr>
<td style="text-align: left;">entrustType</td>
<td style="text-align: left;">int</td>
<td>0 开仓 1平仓</td>
</tr>
<tr>
<td style="text-align: left;">direction</td>
<td style="text-align: left;">int</td>
<td>方向 0买 1卖</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>委托类型 0市价 1限价 2计划委托</td>
</tr>
<tr>
<td style="text-align: left;">symbol</td>
<td style="text-align: left;">src</td>
<td>交易对符号</td>
</tr>
<tr>
<td style="text-align: left;">coinSymbol</td>
<td style="text-align: left;">src</td>
<td>币单位</td>
</tr>
<tr>
<td style="text-align: left;">baseSymbol</td>
<td style="text-align: left;">src</td>
<td>结算单位</td>
</tr>
<tr>
<td style="text-align: left;">triggerPrice</td>
<td style="text-align: left;">double</td>
<td>触发价</td>
</tr>
<tr>
<td style="text-align: left;">entrustPrice</td>
<td style="text-align: left;">double</td>
<td>委托价</td>
</tr>
<tr>
<td style="text-align: left;">lossPrice</td>
<td style="text-align: left;">double</td>
<td>止损触发价</td>
</tr>
<tr>
<td style="text-align: left;">lossEntrustPrice</td>
<td style="text-align: left;">double</td>
<td>止损委托价</td>
</tr>
<tr>
<td style="text-align: left;">profitPrice</td>
<td style="text-align: left;">double</td>
<td>触发价</td>
</tr>
<tr>
<td style="text-align: left;">profitEntrustPrice</td>
<td style="text-align: left;">double</td>
<td>委托价</td>
</tr>
<tr>
<td style="text-align: left;">tradedPrice</td>
<td style="text-align: left;">double</td>
<td>成交均价</td>
</tr>
<tr>
<td style="text-align: left;">principalAmount</td>
<td style="text-align: left;">double</td>
<td>冻结保证金</td>
</tr>
<tr>
<td style="text-align: left;">currentPrice</td>
<td style="text-align: left;">double</td>
<td>下单时价</td>
</tr>
<tr>
<td style="text-align: left;">openFee</td>
<td style="text-align: left;">double</td>
<td>开仓手续费</td>
</tr>
<tr>
<td style="text-align: left;">closeFee</td>
<td style="text-align: left;">double</td>
<td>平仓手续费</td>
</tr>
<tr>
<td style="text-align: left;">shareNumber</td>
<td style="text-align: left;">double</td>
<td>合约面值</td>
</tr>
<tr>
<td style="text-align: left;">volume</td>
<td style="text-align: left;">double</td>
<td>委托数量</td>
</tr>
<tr>
<td style="text-align: left;">tradedVolume</td>
<td style="text-align: left;">double</td>
<td>成交数量</td>
</tr>
<tr>
<td style="text-align: left;">profitAndLoss</td>
<td style="text-align: left;">double</td>
<td>盈亏金额</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>0:委托中/1:已撤销/2:委托失败/3:委托成功</td>
</tr>
<tr>
<td style="text-align: left;">triggeringTime</td>
<td style="text-align: left;">date</td>
<td>触发时间</td>
</tr>
<tr>
<td style="text-align: left;">isFromSpot</td>
<td style="text-align: left;">int</td>
<td>是否是计划委托的委托单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">isReward</td>
<td style="text-align: left;">int</td>
<td>是否已返佣，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">isCut</td>
<td style="text-align: left;">int</td>
<td>是否是止盈止损单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">isOneClose</td>
<td style="text-align: left;">int</td>
<td>是否是一键平仓单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">isMarketAllClose</td>
<td style="text-align: left;">int</td>
<td>是否是市价全平单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">isLimitPrice</td>
<td style="text-align: left;">int</td>
<td>是否是限价成交单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">usdtOpenTime</td>
<td style="text-align: left;">int</td>
<td>开仓时间</td>
</tr>
<tr>
<td style="text-align: left;">usdtOpenPrice</td>
<td style="text-align: left;">double</td>
<td>开仓均价</td>
</tr>
<tr>
<td style="text-align: left;">isReversedOpen</td>
<td style="text-align: left;">int</td>
<td>是否是反向开仓单，0：否，1：是</td>
</tr>
<tr>
<td style="text-align: left;">dealTime</td>
<td style="text-align: left;">int</td>
<td>成交时间</td>
</tr>
<tr>
<td style="text-align: left;">openType</td>
<td style="text-align: left;">int</td>
<td>开仓类型 0市价委托 1限价委托 2计划委托</td>
</tr>
<tr>
<td style="text-align: left;">closeType</td>
<td style="text-align: left;">int</td>
<td>平仓类型 CLOSE平仓 MARKET_CLOSE市价全平 ONE_KEY_CLOSE一键平仓 REVERSE_OPEN反向开仓 CUT止盈止损 BLAST爆仓 ADMIN_CLOSE管理员强平</td>
</tr>
<tr>
<td style="text-align: left;">balance</td>
<td style="text-align: left;">double</td>
<td>账户余额</td>
</tr>
<tr>
<td style="text-align: left;">frozenBalance</td>
<td style="text-align: left;">double</td>
<td>已用保证金</td>
</tr>
<tr>
<td style="text-align: left;">totalFrozenBalance</td>
<td style="text-align: left;">double</td>
<td>总冻结金额</td>
</tr>
<tr>
<td style="text-align: left;">frozenMargin</td>
<td style="text-align: left;">double</td>
<td>冻结保证金</td>
</tr>
<tr>
<td style="text-align: left;">isSupervised</td>
<td style="text-align: left;">int</td>
<td>账户是否被监控</td>
</tr>
<tr>
<td style="text-align: left;">currentCapital</td>
<td style="text-align: left;">double</td>
<td>账户权益</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">src</td>
<td>账户名称</td>
</tr>
<tr>
<td style="text-align: left;">cashBalance</td>
<td style="text-align: left;">double</td>
<td>账户实时总余额</td>
</tr>
<tr>
<td style="text-align: left;">followBalance</td>
<td style="text-align: left;">double</td>
<td>跟单账户余额</td>
</tr>
<tr>
<td style="text-align: left;">currentTodayRevenue</td>
<td style="text-align: left;">double</td>
<td>今日动态收益</td>
</tr>
<tr>
<td style="text-align: left;">todayDeposit</td>
<td style="text-align: left;">double</td>
<td>今日入金</td>
</tr>
<tr>
<td style="text-align: left;">yesterdayBalance</td>
<td style="text-align: left;">double</td>
<td>昨日余额</td>
</tr>
<tr>
<td style="text-align: left;">todayRevenue</td>
<td style="text-align: left;">double</td>
<td>今日收益</td>
</tr>
<tr>
<td style="text-align: left;">availableBalanceForOpen</td>
<td style="text-align: left;">double</td>
<td>可用开仓余额</td>
</tr>
<tr>
<td style="text-align: left;">availableBalance</td>
<td style="text-align: left;">double</td>
<td>可用开仓余额 用于客户端计算可开张数</td>
</tr>
<tr>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td></td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>