分页获取历史订单
<p>[TOC]</p>
<h2>接口描述</h2>
<ul>
<li>分页获取历史订单</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/order/historyOrders</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>20次/2S</li>
</ul>
<h2>参数类型</h2>
<ul>
<li>Query Params</li>
</ul>
<h2>请求参数</h2>
<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>
<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>
<td style="text-align: left;">PERP_BTC_USDT</td>
</tr>
<tr>
<td style="text-align: left;">side</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">买卖方向 BUY:买,SELL:卖</td>
<td style="text-align: left;">BUY</td>
</tr>
<tr>
<td style="text-align: left;">state</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">订单撮合状态 [-3:部分成交已撤销, -2:委托异常, -1:已撤销, 3:全部成交, 5:已过期]</td>
<td style="text-align: left;">5</td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">起始UTC时间戳</td>
<td style="text-align: left;">123456789</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">结束UTC时间戳</td>
<td style="text-align: left;">123456789</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">当前页码 默认第一页</td>
<td style="text-align: left;">1</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td style="text-align: left;">分页数 默认10</td>
<td style="text-align: left;">10</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>curl &#039;{{url-perp-future-service}}/perp/contract/order/historyOrders?page=1&amp;pageSize=10&#039;</code></pre>
<h2>响应参数</h2>
<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>
<tr>
<td style="text-align: left;">data.records</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.records.orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单ID</td>
</tr>
<tr>
<td style="text-align: left;">data.records.userId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.records.symbolId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对ID</td>
</tr>
<tr>
<td style="text-align: left;">data.records.symbol</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对</td>
</tr>
<tr>
<td style="text-align: left;">data.records.side</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">委托方向 [BUY：买,SELL:卖]</td>
</tr>
<tr>
<td style="text-align: left;">data.records.positionSide</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">持仓方向[BOTH:合并持仓（单项） ；多向持仓LONG: 多,SHORT: 空]</td>
</tr>
<tr>
<td style="text-align: left;">data.records.reduceOnly</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">仅减仓</td>
</tr>
<tr>
<td style="text-align: left;">data.records.type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单类型</td>
</tr>
<tr>
<td style="text-align: left;">data.records.quantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">下单数量</td>
</tr>
<tr>
<td style="text-align: left;">data.records.amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">下单数量(USDT)</td>
</tr>
<tr>
<td style="text-align: left;">data.records.price</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">委托价格</td>
</tr>
<tr>
<td style="text-align: left;">data.records.stopPrice</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">计划委托触发价格</td>
</tr>
<tr>
<td style="text-align: left;">data.records.closePosition</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">仅平仓[0:false，1：true]</td>
</tr>
<tr>
<td style="text-align: left;">data.records.leverage</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">杠杆倍数</td>
</tr>
<tr>
<td style="text-align: left;">data.records.averagePrice</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交均价</td>
</tr>
<tr>
<td style="text-align: left;">data.records.filledAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交总金额</td>
</tr>
<tr>
<td style="text-align: left;">data.records.filledQuantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交数量</td>
</tr>
<tr>
<td style="text-align: left;">data.records.filledFees</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交手续费</td>
</tr>
<tr>
<td style="text-align: left;">data.records.feeCurrency</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">手续费币种</td>
</tr>
<tr>
<td style="text-align: left;">data.records.state</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单撮合状态 [-4:撤销中, -3:部分成交已撤销, -2:委托异常, -1:已撤销, 0:已创建(该状态订单尚未进入撮合队列), 1:撮合中, 2.部分成交, 3:全部成交, 4:等待触发, 5:已过期]</td>
</tr>
<tr>
<td style="text-align: left;">data.records.createdAt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单创建时间 时间戳</td>
</tr>
<tr>
<td style="text-align: left;">data.records.canceledAt</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">订单撤销时间 时间戳</td>
</tr>
<tr>
<td style="text-align: left;">data.records.finishedAt</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">订单变为终结态的时间 时间戳</td>
</tr>
<tr>
<td style="text-align: left;">data.records.cancelType</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">撤单类型：0：用户主动撤单，1：系统撤单，2：自成交保护撤单</td>
</tr>
<tr>
<td style="text-align: left;">data.total</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">总记录数</td>
</tr>
<tr>
<td style="text-align: left;">data.size</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">分页大小</td>
</tr>
<tr>
<td style="text-align: left;">data.current</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">当前页</td>
</tr>
<tr>
<td style="text-align: left;">data.orders</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.optimizeCountSql</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.searchCount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.countId</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.maxLimit</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.pages</td>
<td style="text-align: left;">string</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;: {
&quot;records&quot;: [
{
&quot;userId&quot;: 842140539255377920,
&quot;symbolId&quot;: 1,
&quot;symbol&quot;: &quot;PERP_BTC_USDT&quot;,
&quot;side&quot;: &quot;BUY&quot;,
&quot;positionSide&quot;: &quot;BOTH&quot;,
&quot;reduceOnly&quot;: false,
&quot;type&quot;: &quot;LIMIT&quot;,
&quot;quantity&quot;: &quot;0.5&quot;,
&quot;amount&quot;: &quot;29000&quot;,
&quot;price&quot;: &quot;58000&quot;,
&quot;stopPrice&quot;: &quot;0&quot;,
&quot;closePosition&quot;: false,
&quot;leverage&quot;: 100,
&quot;averagePrice&quot;: &quot;0&quot;,
&quot;filledAmount&quot;: &quot;29000&quot;,
&quot;filledQuantity&quot;: &quot;0.5&quot;,
&quot;filledFees&quot;: &quot;0&quot;,
&quot;feeCurrency&quot;: null,
&quot;state&quot;: 3,
&quot;createdAt&quot;: 1728371337406,
&quot;canceledAt&quot;: null,
&quot;finishedAt&quot;: 1728371342970,
&quot;cancelType&quot;: null,
&quot;orderId&quot;: 853781216546721792
},
{
&quot;userId&quot;: 842140539255377920,
&quot;symbolId&quot;: 1,
&quot;symbol&quot;: &quot;PERP_BTC_USDT&quot;,
&quot;side&quot;: &quot;SELL&quot;,
&quot;positionSide&quot;: &quot;BOTH&quot;,
&quot;reduceOnly&quot;: false,
&quot;type&quot;: &quot;LIMIT&quot;,
&quot;quantity&quot;: &quot;0.5&quot;,
&quot;amount&quot;: &quot;29000&quot;,
&quot;price&quot;: &quot;58000&quot;,
&quot;stopPrice&quot;: &quot;0&quot;,
&quot;closePosition&quot;: false,
&quot;leverage&quot;: 100,
&quot;averagePrice&quot;: &quot;0&quot;,
&quot;filledAmount&quot;: &quot;29000&quot;,
&quot;filledQuantity&quot;: &quot;0.5&quot;,
&quot;filledFees&quot;: &quot;0&quot;,
&quot;feeCurrency&quot;: null,
&quot;state&quot;: 3,
&quot;createdAt&quot;: 1728371340286,
&quot;canceledAt&quot;: null,
&quot;finishedAt&quot;: 1728371341082,
&quot;cancelType&quot;: null,
&quot;orderId&quot;: 853781228626317312
}
],
&quot;total&quot;: 2,
&quot;size&quot;: 10,
&quot;current&quot;: 1,
&quot;orders&quot;: [],
&quot;optimizeCountSql&quot;: true,
&quot;searchCount&quot;: true,
&quot;countId&quot;: null,
&quot;maxLimit&quot;: null,
&quot;pages&quot;: 1
}
}</code></pre>
<h2>备注</h2>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>