交易对相关 - 接口集合
<p>[TOC]</p>
<h1>1、获取交易对</h1>
<h2>接口描述</h2>
<ul>
<li>获取永续合约交易对</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/symbol/info</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s</li>
</ul>
<h2>请求参数</h2>
<h3>请求示例</h3>
<pre><code>curl &#039;{{url-perp-future-service}}/perp/contract/symbol/info&#039;</code></pre>
<h3>请求示例</h3>
<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.id</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.base</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">基础币种</td>
</tr>
<tr>
<td style="text-align: left;">data.quote</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">定价币种</td>
</tr>
<tr>
<td style="text-align: left;">data.priceScale</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">价格精度</td>
</tr>
<tr>
<td style="text-align: left;">data.sort</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">排序</td>
</tr>
<tr>
<td style="text-align: left;">data.openTime</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;">启用状态 [0:禁用 1:启用]</td>
</tr>
<tr>
<td style="text-align: left;">data.display</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是否显示 [0:否 1:是]</td>
</tr>
<tr>
<td style="text-align: left;">data.baseScale</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">基础币种精度</td>
</tr>
<tr>
<td style="text-align: left;">data.quoteScale</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">定价币种精度</td>
</tr>
<tr>
<td style="text-align: left;">data.maxLeverage</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大杠杆倍数</td>
</tr>
<tr>
<td style="text-align: left;">data.impactMarginNotional</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">冲击保证金</td>
</tr>
<tr>
<td style="text-align: left;">data.limitMaxOpenOrders</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">限价最大挂单数量</td>
</tr>
<tr>
<td style="text-align: left;">data.minQuantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小下单数量</td>
</tr>
<tr>
<td style="text-align: left;">data.maxQuantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大下单数量</td>
</tr>
<tr>
<td style="text-align: left;">data.minAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小下单名义价值(USD)</td>
</tr>
<tr>
<td style="text-align: left;">data.maxAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大下单名义价值(USD)</td>
</tr>
<tr>
<td style="text-align: left;">data.priceProtectionThreshold</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">价差保护阈值</td>
</tr>
<tr>
<td style="text-align: left;">data.intervalHour</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">费率间隔小时</td>
</tr>
<tr>
<td style="text-align: left;">data.takerRate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">吃单手续费</td>
</tr>
<tr>
<td style="text-align: left;">data.makerRate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">挂单手续费</td>
</tr>
<tr>
<td style="text-align: left;">data.marketLongState</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">市价开仓做多开关[0:关闭,1:开启]</td>
</tr>
<tr>
<td style="text-align: left;">data.marketShortState</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">市价开仓做空开关[0:关闭,1:开启]</td>
</tr>
<tr>
<td style="text-align: left;">data.openLongState</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">开仓做多开关[0:关闭,1:开启]</td>
</tr>
<tr>
<td style="text-align: left;">data.openShortState</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">开仓做空开关[0:关闭,1:开启]</td>
</tr>
<tr>
<td style="text-align: left;">data.triggerEntrustState</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">计划委托开关[0:关闭,1:开启]</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">配置ID</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.symbolId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对ID</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.tier</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">层级</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.minNotionalValue</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小名义价值(USDT)</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.maxNotionalValue</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大名义价值(USDT)</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.maxLeverage</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最高杠杆倍数</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.maintenanceMarginRate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">维持保证金比率</td>
</tr>
<tr>
<td style="text-align: left;">data.leverageMargins.maintenanceAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">维持保证金速算额 (USDT)</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code> {
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: [
{
&quot;id&quot;: 2,
&quot;symbol&quot;: &quot;PERP_ETH_USDT&quot;,
&quot;base&quot;: &quot;ETH&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;priceScale&quot;: 2,
&quot;sort&quot;: 2,
&quot;openTime&quot;: &quot;2023-05-01T00:00:00&quot;,
&quot;state&quot;: 1,
&quot;display&quot;: 1,
&quot;baseScale&quot;: 2,
&quot;quoteScale&quot;: 1,
&quot;maxLeverage&quot;: 125,
&quot;impactMarginNotional&quot;: &quot;500&quot;,
&quot;limitMaxOpenOrders&quot;: 100,
&quot;minQuantity&quot;: &quot;0.0001&quot;,
&quot;maxQuantity&quot;: &quot;50&quot;,
&quot;minAmount&quot;: &quot;10&quot;,
&quot;maxAmount&quot;: &quot;1000000&quot;,
&quot;priceProtectionThreshold&quot;: &quot;0.2&quot;,
&quot;intervalHour&quot;: 8,
&quot;takerRate&quot;: &quot;0.0001&quot;,
&quot;makerRate&quot;: &quot;0.0001&quot;,
&quot;marketLongState&quot;: true,
&quot;marketShortState&quot;: true,
&quot;openLongState&quot;: true,
&quot;openShortState&quot;: true,
&quot;triggerEntrustState&quot;: true,
&quot;leverageMargins&quot;: [
{
&quot;id&quot;: 13,
&quot;symbolId&quot;: 2,
&quot;tier&quot;: 1,
&quot;minNotionalValue&quot;: &quot;0&quot;,
&quot;maxNotionalValue&quot;: &quot;50000&quot;,
&quot;maxLeverage&quot;: 125,
&quot;maintenanceMarginRate&quot;: &quot;0.004&quot;,
&quot;maintenanceAmount&quot;: &quot;0&quot;
}
]
}
]
}</code></pre>
<h1>2、获取交易对杠杆保证金</h1>
<h2>接口描述</h2>
<ul>
<li>获取永续合约交易对杠杆保证金配置</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/symbol/leverageMargin</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s</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;">symbolId</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;">1</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>curl &#039;{{url-perp-future-service}}/perp/contract/symbol/leverageMargin?symbolId=1&#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;">array</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data.id</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.tier</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">层级</td>
</tr>
<tr>
<td style="text-align: left;">data.minNotionalValue</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小名义价值(USDT)</td>
</tr>
<tr>
<td style="text-align: left;">data.maxNotionalValue</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大名义价值(USDT)</td>
</tr>
<tr>
<td style="text-align: left;">data.maxLeverage</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最高杠杆倍数</td>
</tr>
<tr>
<td style="text-align: left;">data.maintenanceMarginRate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">维持保证金比率</td>
</tr>
<tr>
<td style="text-align: left;">data.maintenanceAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">维持保证金速算额 (USDT)</td>
</tr>
</tbody>
</table>
<h3>返回示例</h3>
<pre><code> {
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: [
{
&quot;id&quot;: 1,
&quot;symbolId&quot;: 1,
&quot;tier&quot;: 1,
&quot;minNotionalValue&quot;: &quot;0&quot;,
&quot;maxNotionalValue&quot;: &quot;50000&quot;,
&quot;maxLeverage&quot;: 125,
&quot;maintenanceMarginRate&quot;: &quot;0.004&quot;,
&quot;maintenanceAmount&quot;: &quot;0&quot;
},
{
&quot;id&quot;: 2,
&quot;symbolId&quot;: 1,
&quot;tier&quot;: 2,
&quot;minNotionalValue&quot;: &quot;50000&quot;,
&quot;maxNotionalValue&quot;: &quot;600000&quot;,
&quot;maxLeverage&quot;: 100,
&quot;maintenanceMarginRate&quot;: &quot;0.005&quot;,
&quot;maintenanceAmount&quot;: &quot;50&quot;
}
]
}
</code></pre>