ex-global


Public Websocket

<h2>[TOC]</h2> <h1>k线订阅</h1> <h2>简要描述</h2> <ul> <li>k线订阅</li> </ul> <h2>订阅Topic</h2> <ul> <li><code>&amp;lt;symbol&amp;gt;@s_kline@&amp;lt;period&amp;gt;@&amp;lt;rate&amp;gt;</code></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>说明</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>交易对:BTC_USDT</td> </tr> <tr> <td style="text-align: left;">period</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>间隔参数,详见简介</td> </tr> <tr> <td style="text-align: left;">rate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>返回数据频率 ,详见简介</td> </tr> </tbody> </table> <h2>返回示例</h2> <pre><code>{ &amp;quot;data&amp;quot;:{ &amp;quot;close&amp;quot;:&amp;quot;908.00&amp;quot;,//收盘价(最新价) &amp;quot;closeTime&amp;quot;:1725523560000,//收盘时间 &amp;quot;high&amp;quot;:&amp;quot;100000.00&amp;quot;,//最高价 &amp;quot;lastTime&amp;quot;:1725589271173,//最后更新时间戳 &amp;quot;low&amp;quot;:&amp;quot;1.00&amp;quot;,//最低价 &amp;quot;open&amp;quot;:&amp;quot;1.00&amp;quot;,//开盘价 &amp;quot;openTime&amp;quot;:1725523500000,//开盘时间 &amp;quot;period&amp;quot;:&amp;quot;1m&amp;quot;,//间隔参数 &amp;quot;qty&amp;quot;:&amp;quot;13637429.0000&amp;quot;,//成交量 &amp;quot;symbol&amp;quot;:&amp;quot;BTC_USDT&amp;quot;,//交易对 &amp;quot;vol&amp;quot;:&amp;quot;13779526500.00&amp;quot;//成交额 }, &amp;quot;topic&amp;quot;:&amp;quot;BTC_USDT@s_kline@1m@1000ms&amp;quot;,//topic &amp;quot;type&amp;quot;:&amp;quot;s_kline&amp;quot;//类型 }</code></pre> <hr /> <h1>实时成交订阅</h1> <h2>简要描述</h2> <ul> <li>实时成交订阅</li> </ul> <h2>订阅Topic</h2> <ul> <li><code>&amp;lt;symbol&amp;gt;@s_trade</code></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>说明</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>交易对:BTC_USDT</td> </tr> </tbody> </table> <h2>返回示例</h2> <pre><code>{ &amp;quot;data&amp;quot;: [{ &amp;quot;amount&amp;quot;: &amp;quot;1816&amp;quot;,//成交额 &amp;quot;id&amp;quot;: &amp;quot;850114-1&amp;quot;,//唯一id &amp;quot;price&amp;quot;: &amp;quot;908&amp;quot;,//价格 &amp;quot;qty&amp;quot;: &amp;quot;2&amp;quot;,//数量 &amp;quot;side&amp;quot;: &amp;quot;SELL&amp;quot;,//买卖方向 &amp;quot;symbol&amp;quot;: &amp;quot;BTC_USDT&amp;quot;,//交易对 &amp;quot;ts&amp;quot;: 1725679060986 //成交时间戳 }], &amp;quot;topic&amp;quot;: &amp;quot;BTC_USDT@s_trade&amp;quot;,//topic &amp;quot;type&amp;quot;: &amp;quot;s_trade&amp;quot;//类型 }</code></pre> <hr /> <h1>深度订阅</h1> <h2>简要描述</h2> <ul> <li>深度订阅</li> </ul> <h2>订阅Topic</h2> <ul> <li><code>&amp;lt;symbol&amp;gt;@s_depth@&amp;lt;rate&amp;gt;</code></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>说明</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>交易对:BTC_USDT</td> </tr> <tr> <td style="text-align: left;">rate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>返回数据频率 ,详见简介</td> </tr> </tbody> </table> <h2>返回示例</h2> <pre><code>{ &amp;quot;data&amp;quot;: { &amp;quot;asks&amp;quot;: [//卖盘 [908, 2]//下标0为价格,下标1为数量 ], &amp;quot;bids&amp;quot;: [//买盘 [907, 8]//下标0为价格,下标1为数量 ], &amp;quot;seq&amp;quot;: 850117,//更新id &amp;quot;symbol&amp;quot;: &amp;quot;BTC_USDT&amp;quot;,//交易对 &amp;quot;ts&amp;quot;: 1725679871815//更新时间 }, &amp;quot;topic&amp;quot;: &amp;quot;BTC_USDT@s_depth@rt&amp;quot;,//topic &amp;quot;type&amp;quot;: &amp;quot;s_depth&amp;quot;//订阅类型 }</code></pre> <h2>备注</h2> <ul> <li> <h2>订阅 wss://gstream.hidev.me/ws/v3/market 1.开始缓存收到的更新。同一个价位,后收到的更新覆盖前面的。 2.访问Rest-api接口 /market/online/depth/BTC_USDT/1000 获得一个1000档的深度快照 3.将目前缓存到的信息中seq小于步骤3中获取到的快照中的seq的部分丢弃(丢弃更早的信息,已经过期)。 4.将深度快照中的内容更新到本地orderbook副本中,并从websocket接收到的第一个seq &lt;= 快照seq+1  的event开始继续更新本地副本。 5.每一个新event的U应该恰好等于上一个event的seq+1,否则可能出现了丢包,请从step3重新进行初始化。 6.每一个event中的挂单量代表这个价格目前的挂单量绝对值,而不是相对变化。 7.如果某个价格对应的挂单量为0,表示该价位的挂单已经撤单或者被吃,应该移除这个价位。</h2> </li> </ul> <h1>Ticker行情快照订阅</h1> <h2>简要描述</h2> <ul> <li>Ticker行情快照订阅</li> </ul> <h2>订阅Topic</h2> <ul> <li><code>&amp;lt;symbol&amp;gt;@s_ticker</code></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>说明</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>交易对:BTC_USDT ,传_spot可订阅所有交易对</td> </tr> </tbody> </table> <h2>返回示例</h2> <pre><code>{ &amp;quot;data&amp;quot;: [{ &amp;quot;ask&amp;quot;: &amp;quot;907.00&amp;quot;,//最优卖盘价 &amp;quot;askQty&amp;quot;: &amp;quot;12.0000&amp;quot;,//最优卖盘数量 &amp;quot;bid&amp;quot;: &amp;quot;907.00&amp;quot;,//最优买盘价 &amp;quot;bidQty&amp;quot;: &amp;quot;12.0000&amp;quot;,//最优买盘数量 &amp;quot;close&amp;quot;: &amp;quot;13662155.0000&amp;quot;,//24h收盘价 &amp;quot;high&amp;quot;: &amp;quot;100000.00&amp;quot;,//24h最高价 &amp;quot;lastPrice&amp;quot;: &amp;quot;908.00&amp;quot;,//最后成交价格 &amp;quot;lastSize&amp;quot;: &amp;quot;2.0000&amp;quot;,//最后成交数量 &amp;quot;low&amp;quot;: &amp;quot;1.00&amp;quot;,//24h最低价 &amp;quot;open&amp;quot;: &amp;quot;1.00&amp;quot;,//24h开盘价 &amp;quot;qty&amp;quot;: &amp;quot;13662155.0000&amp;quot;,//24小时成交量 &amp;quot;riseAndFall&amp;quot;: &amp;quot;13662154.0000&amp;quot;,//涨跌幅% &amp;quot;symbol&amp;quot;: &amp;quot;BTC_USDT&amp;quot;,//交易对 &amp;quot;vol&amp;quot;: &amp;quot;13788654949.00&amp;quot;//24小时成交额 }], &amp;quot;topic&amp;quot;: &amp;quot;_spot@s_ticker&amp;quot;,//topic &amp;quot;type&amp;quot;: &amp;quot;s_ticker&amp;quot;//订阅类型 }</code></pre> <h2>备注</h2> <p>可订阅一个或多个交易对</p>

页面列表

ITEM_HTML