Public Websocket
<h2>[TOC]</h2>
<h1>k线订阅</h1>
<h2>简要描述</h2>
<ul>
<li>k线订阅</li>
</ul>
<h2>订阅Topic</h2>
<ul>
<li><code>&lt;symbol&gt;@s_kline@&lt;period&gt;@&lt;rate&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>{
&quot;data&quot;:{
&quot;close&quot;:&quot;908.00&quot;,//收盘价(最新价)
&quot;closeTime&quot;:1725523560000,//收盘时间
&quot;high&quot;:&quot;100000.00&quot;,//最高价
&quot;lastTime&quot;:1725589271173,//最后更新时间戳
&quot;low&quot;:&quot;1.00&quot;,//最低价
&quot;open&quot;:&quot;1.00&quot;,//开盘价
&quot;openTime&quot;:1725523500000,//开盘时间
&quot;period&quot;:&quot;1m&quot;,//间隔参数
&quot;qty&quot;:&quot;13637429.0000&quot;,//成交量
&quot;symbol&quot;:&quot;BTC_USDT&quot;,//交易对
&quot;vol&quot;:&quot;13779526500.00&quot;//成交额
},
&quot;topic&quot;:&quot;BTC_USDT@s_kline@1m@1000ms&quot;,//topic
&quot;type&quot;:&quot;s_kline&quot;//类型
}</code></pre>
<hr />
<h1>实时成交订阅</h1>
<h2>简要描述</h2>
<ul>
<li>实时成交订阅</li>
</ul>
<h2>订阅Topic</h2>
<ul>
<li><code>&lt;symbol&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>{
&quot;data&quot;: [{
&quot;amount&quot;: &quot;1816&quot;,//成交额
&quot;id&quot;: &quot;850114-1&quot;,//唯一id
&quot;price&quot;: &quot;908&quot;,//价格
&quot;qty&quot;: &quot;2&quot;,//数量
&quot;side&quot;: &quot;SELL&quot;,//买卖方向
&quot;symbol&quot;: &quot;BTC_USDT&quot;,//交易对
&quot;ts&quot;: 1725679060986 //成交时间戳
}],
&quot;topic&quot;: &quot;BTC_USDT@s_trade&quot;,//topic
&quot;type&quot;: &quot;s_trade&quot;//类型
}</code></pre>
<hr />
<h1>深度订阅</h1>
<h2>简要描述</h2>
<ul>
<li>深度订阅</li>
</ul>
<h2>订阅Topic</h2>
<ul>
<li><code>&lt;symbol&gt;@s_depth@&lt;rate&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>{
&quot;data&quot;: {
&quot;asks&quot;: [//卖盘
[908, 2]//下标0为价格,下标1为数量
],
&quot;bids&quot;: [//买盘
[907, 8]//下标0为价格,下标1为数量
],
&quot;seq&quot;: 850117,//更新id
&quot;symbol&quot;: &quot;BTC_USDT&quot;,//交易对
&quot;ts&quot;: 1725679871815//更新时间
},
&quot;topic&quot;: &quot;BTC_USDT@s_depth@rt&quot;,//topic
&quot;type&quot;: &quot;s_depth&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 <= 快照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>&lt;symbol&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>{
&quot;data&quot;: [{
&quot;ask&quot;: &quot;907.00&quot;,//最优卖盘价
&quot;askQty&quot;: &quot;12.0000&quot;,//最优卖盘数量
&quot;bid&quot;: &quot;907.00&quot;,//最优买盘价
&quot;bidQty&quot;: &quot;12.0000&quot;,//最优买盘数量
&quot;close&quot;: &quot;13662155.0000&quot;,//24h收盘价
&quot;high&quot;: &quot;100000.00&quot;,//24h最高价
&quot;lastPrice&quot;: &quot;908.00&quot;,//最后成交价格
&quot;lastSize&quot;: &quot;2.0000&quot;,//最后成交数量
&quot;low&quot;: &quot;1.00&quot;,//24h最低价
&quot;open&quot;: &quot;1.00&quot;,//24h开盘价
&quot;qty&quot;: &quot;13662155.0000&quot;,//24小时成交量
&quot;riseAndFall&quot;: &quot;13662154.0000&quot;,//涨跌幅%
&quot;symbol&quot;: &quot;BTC_USDT&quot;,//交易对
&quot;vol&quot;: &quot;13788654949.00&quot;//24小时成交额
}],
&quot;topic&quot;: &quot;_spot@s_ticker&quot;,//topic
&quot;type&quot;: &quot;s_ticker&quot;//订阅类型
}</code></pre>
<h2>备注</h2>
<p>可订阅一个或多个交易对</p>