获取成交详情
<p>[TOC]</p>
<h2>接口描述</h2>
<ul>
<li>根据订单号获取成交列表详情</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/order/tradeDetail</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>10次/s</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;">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;">853781216546721792</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>curl '{{url-perp-future-service}}/perp/contract/order/tradeDetail?orderId=853781216546721792'</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;">array</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.tradeId</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.orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID</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.symbol</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对</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.positionSide</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">持仓方向[LONG: 多,SHORT: 空]</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.quantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交数量</td>
</tr>
<tr>
<td style="text-align: left;">data.amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交额</td>
</tr>
<tr>
<td style="text-align: left;">data.commission</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成交手续费</td>
</tr>
<tr>
<td style="text-align: left;">data.commissionAsset</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">手续费计价币种</td>
</tr>
<tr>
<td style="text-align: left;">data.maker</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.realizedPnl</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">实现盈亏平仓才有</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.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>
</tbody>
</table>
<h3>响应示例</h3>
<pre><code>{
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: [
{
&quot;userId&quot;: 842140539255377920,
&quot;orderId&quot;: 853781216546721792,
&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;price&quot;: &quot;58000&quot;,
&quot;quantity&quot;: &quot;0.5&quot;,
&quot;amount&quot;: &quot;29000&quot;,
&quot;commission&quot;: &quot;0&quot;,
&quot;commissionAsset&quot;: &quot;USDT&quot;,
&quot;maker&quot;: true,
&quot;realizedPnl&quot;: &quot;0&quot;,
&quot;createdAt&quot;: 1728371343667,
&quot;createTime&quot;: &quot;2024-10-08 15:09:05&quot;,
&quot;updateTime&quot;: &quot;2024-10-16 23:20:48&quot;,
&quot;tradeId&quot;: 7
}
]
}</code></pre>
<h2>备注</h2>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>