交易对相关
<p>[TOC]</p>
<h1>1、交易规则</h1>
<h2>接口描述</h2>
<ul>
<li>获取永续合约交易对</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/symbol/tradingRules</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;">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;">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/symbol/tradingRules&#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.symbol</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易对</td>
</tr>
<tr>
<td style="text-align: left;">data.minTradeAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小下单数量（合约单笔限价订单的最小下单数量）</td>
</tr>
<tr>
<td style="text-align: left;">data.minOrderPrice</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小下单价格（合约的最小下单价格）</td>
</tr>
<tr>
<td style="text-align: left;">data.minPriceMovement</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最小价格波动 （合约价格变动的最小单位价格）</td>
</tr>
<tr>
<td style="text-align: left;">data.pricePrecision</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">价格精度 （价格精度与止盈和止损订单的标记价格精度有关）</td>
</tr>
<tr>
<td style="text-align: left;">data.limitOrderPriceCapRatio</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">限价单价格上限比例 （限价买单价格应小于或等于（1+价格上限比例）*合约当前标记价格）</td>
</tr>
<tr>
<td style="text-align: left;">data.limitOrderPriceFloorRatio</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">限价单价格下限比例 （限价卖单价格应大于或等于（1-价格下限比例）*合约当前标记价格。）</td>
</tr>
<tr>
<td style="text-align: left;">data.maxMarketOrderAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">市价单单笔最大数量 (合约单笔市价订单最大下单数量)</td>
</tr>
<tr>
<td style="text-align: left;">data.maxLimitOrderAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">限价单单笔最大数量 (合约单笔限价订单的最大下单数量)</td>
</tr>
<tr>
<td style="text-align: left;">data.maxNumberOfOpenOrders</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">最大挂单数量(订单数量包含每个独立仓位的未平仓限价单和条件单)</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.liquidationClearanceFee</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;">最小名义价值 (每笔合约订单的最小名义价值)</td>
</tr>
<tr>
<td style="text-align: left;">data.marketOrderPriceCapRatio</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">市价单价格上限比例 (在极端市场行情中，如果市场价格与标记价格的偏离程度达到市价单价格上限比例的阈值，市价单可能会失效或只能部分成交)</td>
</tr>
<tr>
<td style="text-align: left;">data.marketOrderPriceFloorRatio</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;symbol&quot;: &quot;PERP_BTC_USDT&quot;,
&quot;base&quot;: &quot;BTC&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;minTradeAmount&quot;: &quot;0.0001&quot;,
&quot;minPriceMovement&quot;: &quot;96000&quot;,
&quot;pricePrecision&quot;: &quot;0.01&quot;,
&quot;limitOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;limitOrderPriceFloorRatio&quot;: &quot;0&quot;,
&quot;maxMarketOrderAmount&quot;: &quot;500&quot;,
&quot;maxLimitOrderAmount&quot;: &quot;500&quot;,
&quot;maxNumberOfOpenOrders&quot;: 100,
&quot;priceProtectionThreshold&quot;: &quot;0.2&quot;,
&quot;liquidationClearanceFee&quot;: &quot;0.22&quot;,
&quot;minNotionalValue&quot;: &quot;10&quot;,
&quot;marketOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;marketOrderPriceFloorRatio&quot;: &quot;0&quot;
},
{
&quot;symbol&quot;: &quot;PERP_ETH_USDT&quot;,
&quot;base&quot;: &quot;ETH&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;minTradeAmount&quot;: &quot;0.0001&quot;,
&quot;minPriceMovement&quot;: &quot;12&quot;,
&quot;pricePrecision&quot;: &quot;0.1&quot;,
&quot;limitOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;limitOrderPriceFloorRatio&quot;: &quot;0&quot;,
&quot;maxMarketOrderAmount&quot;: &quot;500&quot;,
&quot;maxLimitOrderAmount&quot;: &quot;500&quot;,
&quot;maxNumberOfOpenOrders&quot;: 100,
&quot;priceProtectionThreshold&quot;: &quot;0.2&quot;,
&quot;liquidationClearanceFee&quot;: &quot;0.22&quot;,
&quot;minNotionalValue&quot;: &quot;10&quot;,
&quot;marketOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;marketOrderPriceFloorRatio&quot;: &quot;0&quot;
},
{
&quot;symbol&quot;: &quot;PERP_SOL_USDT&quot;,
&quot;base&quot;: &quot;SOL&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;minTradeAmount&quot;: &quot;0.0001&quot;,
&quot;minPriceMovement&quot;: &quot;200&quot;,
&quot;pricePrecision&quot;: &quot;0.1&quot;,
&quot;limitOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;limitOrderPriceFloorRatio&quot;: &quot;0&quot;,
&quot;maxMarketOrderAmount&quot;: &quot;500&quot;,
&quot;maxLimitOrderAmount&quot;: &quot;500&quot;,
&quot;maxNumberOfOpenOrders&quot;: 100,
&quot;priceProtectionThreshold&quot;: &quot;0.2&quot;,
&quot;liquidationClearanceFee&quot;: &quot;0.22&quot;,
&quot;minNotionalValue&quot;: &quot;10&quot;,
&quot;marketOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;marketOrderPriceFloorRatio&quot;: &quot;0&quot;
},
{
&quot;symbol&quot;: &quot;PERP_DOGE_USDT&quot;,
&quot;base&quot;: &quot;DOGE&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;minTradeAmount&quot;: &quot;100&quot;,
&quot;minPriceMovement&quot;: &quot;0.21403&quot;,
&quot;pricePrecision&quot;: &quot;0.00001&quot;,
&quot;limitOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;limitOrderPriceFloorRatio&quot;: &quot;0&quot;,
&quot;liquidationClearanceFee&quot;: &quot;0.22&quot;,
&quot;minNotionalValue&quot;: &quot;10&quot;,
&quot;marketOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;marketOrderPriceFloorRatio&quot;: &quot;0&quot;
},
{
&quot;symbol&quot;: &quot;PERP_SHIB_USDT&quot;,
&quot;base&quot;: &quot;SHIB&quot;,
&quot;quote&quot;: &quot;USDT&quot;,
&quot;minTradeAmount&quot;: &quot;5000&quot;,
&quot;minPriceMovement&quot;: &quot;0.000021111&quot;,
&quot;pricePrecision&quot;: &quot;0.0001&quot;,
&quot;limitOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;limitOrderPriceFloorRatio&quot;: &quot;0&quot;,
&quot;maxMarketOrderAmount&quot;: &quot;100000000&quot;,
&quot;maxLimitOrderAmount&quot;: &quot;100000000&quot;,
&quot;maxNumberOfOpenOrders&quot;: 100,
&quot;priceProtectionThreshold&quot;: &quot;0.2&quot;,
&quot;liquidationClearanceFee&quot;: &quot;0.22&quot;,
&quot;minNotionalValue&quot;: &quot;10&quot;,
&quot;marketOrderPriceCapRatio&quot;: &quot;0&quot;,
&quot;marketOrderPriceFloorRatio&quot;: &quot;0&quot;
}
],
&quot;total&quot;: 5,
&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>
<h1>2、获取交易对杠杆保证金交易对列表</h1>
<h2>接口描述</h2>
<ul>
<li>获取永续合约交易对杠杆保证金交易对列表</li>
</ul>
<h2>HTTP请求</h2>
<ul>
<li>GET <code>/perp/contract/symbol/leverageMarginSymbols</code></li>
</ul>
<h2>请求限流</h2>
<ul>
<li>1次/1s
<h2>参数类型</h2></li>
<li>
<h2>请求参数</h2>
</li>
<li>
<h3>请求示例</h3>
<pre><code>curl &#039;{{url-perp-future-service}}/perp/contract/symbol/leverageMarginSymbols&#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.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>
</tbody>
</table>
</li>
</ul>
<h3>返回示例</h3>
<pre><code> {
&quot;code&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: [
{
&quot;symbolId&quot;: 1,
&quot;symbol&quot;: &quot;PERP_BTC_USDT&quot;
},
{
&quot;symbolId&quot;: 7,
&quot;symbol&quot;: &quot;PERP_SOL_USDT&quot;
},
{
&quot;symbolId&quot;: 2,
&quot;symbol&quot;: &quot;PERP_ETH_USDT&quot;
},
{
&quot;symbolId&quot;: 24,
&quot;symbol&quot;: &quot;PERP_DOGE_USDT&quot;
},
{
&quot;symbolId&quot;: 12,
&quot;symbol&quot;: &quot;PERP_SHIB_USDT&quot;
}
]
}</code></pre>
<h1>3、获取交易对杠杆保证金</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>