ex-global


交易对相关 - 接口集合

<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 &amp;#039;{{url-perp-future-service}}/perp/contract/symbol/info&amp;#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> { &amp;quot;code&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;Success&amp;quot;, &amp;quot;data&amp;quot;: [ { &amp;quot;id&amp;quot;: 2, &amp;quot;symbol&amp;quot;: &amp;quot;PERP_ETH_USDT&amp;quot;, &amp;quot;base&amp;quot;: &amp;quot;ETH&amp;quot;, &amp;quot;quote&amp;quot;: &amp;quot;USDT&amp;quot;, &amp;quot;priceScale&amp;quot;: 2, &amp;quot;sort&amp;quot;: 2, &amp;quot;openTime&amp;quot;: &amp;quot;2023-05-01T00:00:00&amp;quot;, &amp;quot;state&amp;quot;: 1, &amp;quot;display&amp;quot;: 1, &amp;quot;baseScale&amp;quot;: 2, &amp;quot;quoteScale&amp;quot;: 1, &amp;quot;maxLeverage&amp;quot;: 125, &amp;quot;impactMarginNotional&amp;quot;: &amp;quot;500&amp;quot;, &amp;quot;limitMaxOpenOrders&amp;quot;: 100, &amp;quot;minQuantity&amp;quot;: &amp;quot;0.0001&amp;quot;, &amp;quot;maxQuantity&amp;quot;: &amp;quot;50&amp;quot;, &amp;quot;minAmount&amp;quot;: &amp;quot;10&amp;quot;, &amp;quot;maxAmount&amp;quot;: &amp;quot;1000000&amp;quot;, &amp;quot;priceProtectionThreshold&amp;quot;: &amp;quot;0.2&amp;quot;, &amp;quot;intervalHour&amp;quot;: 8, &amp;quot;takerRate&amp;quot;: &amp;quot;0.0001&amp;quot;, &amp;quot;makerRate&amp;quot;: &amp;quot;0.0001&amp;quot;, &amp;quot;marketLongState&amp;quot;: true, &amp;quot;marketShortState&amp;quot;: true, &amp;quot;openLongState&amp;quot;: true, &amp;quot;openShortState&amp;quot;: true, &amp;quot;triggerEntrustState&amp;quot;: true, &amp;quot;leverageMargins&amp;quot;: [ { &amp;quot;id&amp;quot;: 13, &amp;quot;symbolId&amp;quot;: 2, &amp;quot;tier&amp;quot;: 1, &amp;quot;minNotionalValue&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;maxNotionalValue&amp;quot;: &amp;quot;50000&amp;quot;, &amp;quot;maxLeverage&amp;quot;: 125, &amp;quot;maintenanceMarginRate&amp;quot;: &amp;quot;0.004&amp;quot;, &amp;quot;maintenanceAmount&amp;quot;: &amp;quot;0&amp;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 &amp;#039;{{url-perp-future-service}}/perp/contract/symbol/leverageMargin?symbolId=1&amp;#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> { &amp;quot;code&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;Success&amp;quot;, &amp;quot;data&amp;quot;: [ { &amp;quot;id&amp;quot;: 1, &amp;quot;symbolId&amp;quot;: 1, &amp;quot;tier&amp;quot;: 1, &amp;quot;minNotionalValue&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;maxNotionalValue&amp;quot;: &amp;quot;50000&amp;quot;, &amp;quot;maxLeverage&amp;quot;: 125, &amp;quot;maintenanceMarginRate&amp;quot;: &amp;quot;0.004&amp;quot;, &amp;quot;maintenanceAmount&amp;quot;: &amp;quot;0&amp;quot; }, { &amp;quot;id&amp;quot;: 2, &amp;quot;symbolId&amp;quot;: 1, &amp;quot;tier&amp;quot;: 2, &amp;quot;minNotionalValue&amp;quot;: &amp;quot;50000&amp;quot;, &amp;quot;maxNotionalValue&amp;quot;: &amp;quot;600000&amp;quot;, &amp;quot;maxLeverage&amp;quot;: 100, &amp;quot;maintenanceMarginRate&amp;quot;: &amp;quot;0.005&amp;quot;, &amp;quot;maintenanceAmount&amp;quot;: &amp;quot;50&amp;quot; } ] } </code></pre>

页面列表

ITEM_HTML