获取订单详情
<p>[TOC]</p>
<h2>接口描述</h2>
<ul>
<li>获取订单详情以及成交详情</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/spot/order/orderTradeDetails</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;">BTC_USDT</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">订单Id</td>
<td style="text-align: left;">823361860229500928</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>curl '{{url-spot-biz-service}}/spot/order/orderTradeDetails?symbol=BTC_USDT&amp;orderId=823361860229500928'</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.orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单ID</td>
</tr>
<tr>
<td style="text-align: left;">data.userId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.symbol</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对</td>
</tr>
<tr>
<td style="text-align: left;">data.clientOrderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">代理商订单编号</td>
</tr>
<tr>
<td style="text-align: left;">data.symbolId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对Id</td>
</tr>
<tr>
<td style="text-align: left;">data.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.type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单类型[MARKET:市价单,LIMIT:限价单]</td>
</tr>
<tr>
<td style="text-align: left;">data.payment</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">支付类型[Total:交易额,Amount:交易量]</td>
</tr>
<tr>
<td style="text-align: left;">data.amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单金额或数量 （根据side BUY:TOTAL 交易额,SELL:AMOUNT 交易量）</td>
</tr>
<tr>
<td style="text-align: left;">data.orderAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单下单交易量</td>
</tr>
<tr>
<td style="text-align: left;">data.orderTotal</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单下单交易额</td>
</tr>
<tr>
<td style="text-align: left;">data.price</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单价格</td>
</tr>
<tr>
<td style="text-align: left;">data.stopPrice</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">止盈止损订单触发价格</td>
</tr>
<tr>
<td style="text-align: left;">data.averagePrice</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交均价</td>
</tr>
<tr>
<td style="text-align: left;">data.filledCashAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交总金额</td>
</tr>
<tr>
<td style="text-align: left;">data.filledAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交数量</td>
</tr>
<tr>
<td style="text-align: left;">data.filledFees</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">已成交手续费</td>
</tr>
<tr>
<td style="text-align: left;">data.feeCurrency</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">手续费币种</td>
</tr>
<tr>
<td style="text-align: left;">data.volumnRatio</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单完成率</td>
</tr>
<tr>
<td style="text-align: left;">data.state</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单撮合状态 [-1:已撤销,0:已创建(该状态订单尚未进入撮合队列),1:已提交,2:部分成交,3:完全成交]</td>
</tr>
<tr>
<td style="text-align: left;">data.createdAt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单创建时间</td>
</tr>
<tr>
<td style="text-align: left;">data.canceledAt</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">订单撤销时间</td>
</tr>
<tr>
<td style="text-align: left;">data.finishedAt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单变为终结态的时间</td>
</tr>
<tr>
<td style="text-align: left;">data.createTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">创建时间</td>
</tr>
<tr>
<td style="text-align: left;">data.updateTime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">更新时间</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;">成交记录列表</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.tradeId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交ID</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单ID</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.userId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.symbol</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.symbolId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对Id</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.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.detailList.type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单类型</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.price</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交价格</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.filledAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交数量</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.filledFees</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易所手续费交易手续费（正值）或交易返佣金（负值）</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.filledTotal</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">成交金额</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.feeCurrency</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易手续费或交易返佣币种</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.role</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交角色 maker,taker</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.createdAt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">该成交记录创建的时间戳</td>
</tr>
<tr>
<td style="text-align: left;">data.detailList.createTime</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;orderId&quot;: &quot;823361860229500928&quot;,
&quot;userId&quot;: &quot;842140539255377920&quot;,
&quot;symbol&quot;: &quot;BTC_USDT&quot;,
&quot;clientOrderId&quot;: &quot;823361859763916800&quot;,
&quot;symbolId&quot;: 1,
&quot;side&quot;: &quot;BUY&quot;,
&quot;type&quot;: &quot;MARKET&quot;,
&quot;payment&quot;: &quot;TOTAL&quot;,
&quot;amount&quot;: &quot;100&quot;,
&quot;orderAmount&quot;: &quot;0.00159&quot;,
&quot;orderTotal&quot;: &quot;100&quot;,
&quot;price&quot;: &quot;0&quot;,
&quot;stopPrice&quot;: &quot;0&quot;,
&quot;averagePrice&quot;: &quot;62576.13&quot;,
&quot;filledCashAmount&quot;: &quot;99.4960539&quot;,
&quot;filledAmount&quot;: &quot;0.00159&quot;,
&quot;filledFees&quot;: &quot;0&quot;,
&quot;feeCurrency&quot;: &quot;BTC&quot;,
&quot;volumnRatio&quot;: &quot;99.5&quot;,
&quot;state&quot;: 3,
&quot;createdAt&quot;: 1721118797711,
&quot;canceledAt&quot;: null,
&quot;finishedAt&quot;: 1721118797822,
&quot;createTime&quot;: &quot;2024-07-16T16:33:17&quot;,
&quot;updateTime&quot;: &quot;2024-10-16T20:43:25&quot;,
&quot;detailList&quot;: [
{
&quot;tradeId&quot;: 823361860770689024,
&quot;orderId&quot;: 823361860229500928,
&quot;userId&quot;: 842140539255377920,
&quot;symbol&quot;: &quot;BTC_USDT&quot;,
&quot;symbolId&quot;: 1,
&quot;side&quot;: &quot;BUY&quot;,
&quot;type&quot;: &quot;buy-market&quot;,
&quot;price&quot;: &quot;62576.91&quot;,
&quot;filledAmount&quot;: &quot;0.00022&quot;,
&quot;filledFees&quot;: &quot;0.00000044&quot;,
&quot;filledTotal&quot;: null,
&quot;feeCurrency&quot;: &quot;BTC&quot;,
&quot;role&quot;: &quot;maker&quot;,
&quot;createdAt&quot;: 1721118797919,
&quot;createTime&quot;: &quot;2024-07-16T16:33:17&quot;
},
{
&quot;tradeId&quot;: 823361861282308096,
&quot;orderId&quot;: 823361860229500928,
&quot;userId&quot;: 842140539255377920,
&quot;symbol&quot;: &quot;BTC_USDT&quot;,
&quot;symbolId&quot;: 1,
&quot;side&quot;: &quot;BUY&quot;,
&quot;type&quot;: &quot;buy-market&quot;,
&quot;price&quot;: &quot;62576.01&quot;,
&quot;filledAmount&quot;: &quot;0.00137&quot;,
&quot;filledFees&quot;: &quot;0.00000274&quot;,
&quot;filledTotal&quot;: null,
&quot;feeCurrency&quot;: &quot;BTC&quot;,
&quot;role&quot;: &quot;maker&quot;,
&quot;createdAt&quot;: 1721118797966,
&quot;createTime&quot;: &quot;2024-07-16T16:33:17&quot;
}
]
}
}</code></pre>
<h2>备注</h2>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>