Huobi(现更名为 HTX)是一家国际多语言加密货币交易所。
若要订阅私有账户更新,需要在您的 Huobi 账户中创建 API 密钥。创建后,在 Huobi API 客户端中设置 API 密钥和 Secret。
如果 ApiKey 不为空,客户端将尝试连接到私有 WebSocket 服务器,因此只有私有方法可用。如果 ApiKey 为空,客户端将连接到公共 WebSocket 服务器,只有公共方法可用。如果您需要订阅公共和私有方法,则需要两个连接。
您可以订阅以下公共频道(无需 API 密钥)
| 方法 | 描述 |
| SubscribeKLine | 每当有新的 K 线时,此主题会发送新 K 线。支持的周期:1min、5min、15min、30min、60min、4hour、1day、1mon、1week、1year。 |
| SubscribeMarketDepth | 此主题以 1 秒间隔快照模式推送最新的市场深度订单簿。支持的深度聚合级别:step0 至 step15。 |
| SubscribeTradeDetail | 该主题推送最新的已完成成交记录,以逐笔模式更新。 |
| SubscribeMarketDetail |
本主题推送最新的市场统计数据,包含 24 小时摘要。以快照模式更新,频率不超过每秒 10 次。 |
| SubscribeBBO | 用户可以逐笔接收 BBO(最优买卖报价)更新。 |
| SubscribeMarketTicker |
获取市场行情。数据每 100 毫秒推送一次。 |
| SubscribeMarketByPrice | 用户可订阅此频道以接收 Market By Price 订单簿的刷新更新。更新间隔约为 100ms。支持的档位:5、10、20、150、400。 |
以下方法适用于期货 API 客户端(TsgcWS_API_Huobi_Fut),且在上述所有公共方法的基础上额外提供。
| 方法 | 描述 |
| SubscribeIncrementalMarketDepth | 订阅具有可配置大小和数据类型(快照或增量)的增量市场深度更新。 |
| SubscribePremiumIndexKLine | 订阅期货合约的溢价指数 K 线/蜡烛图数据。 |
| SubscribeEstimatedRateKLine | 订阅期货合约的预估资金费率K线/蜡烛图数据。 |
| SubscribeBasisData | 订阅基差数据(现货与期货价差)。支持不同的基差价格类型:开盘价、收盘价、最高价、最低价。 |
| SubscribeMarkPriceKLine | 订阅期货合约的标记价格K线/蜡烛图数据。 |
| SubscribeLiquidationOrders | 订阅指定合约的公开强平订单推送。无需认证。 |
| SubscribeFundingRate | 订阅给定合约的公开资金费率更新。无需认证。 |
| SubscribeContractInfo | 订阅合约参数变化(例如合约上市、下市、参数调整)。 |
您可以订阅以下私有频道(需要 API 密钥)。若凭据不正确,连接将自动关闭。
| 方法 | 描述 |
| SubscribeOrderUpdates |
订单更新可由以下任一情况触发:
|
| SubscribeTradeClearing | 仅在订单处于交易中或取消时更新。订单交易更新为逐笔模式,这意味着如果吃单方的订单与多个挂单方的订单匹配,则同时发生的多笔交易将逐一推送。但多笔交易的更新顺序可能与实际交易顺序不完全一致。此外,如果订单在部分成交后立即被自动取消(例如典型的 IOC 订单),该频道可能会在交易推送之前先推送取消更新。 |
| SubscribeAccountChange |
订阅字段值指定后,更新可由以下任一事件触发。aMode 参数控制更新行为:
模式 0:仅在账户余额变化时更新。 模式 1:当账户余额或可用余额发生变化时更新(分别更新)。 模式 2:当账户余额或可用余额发生变化时更新(合并更新)。 |
OnHuobiSubscribed:订阅成功后调用的事件。
OnHuobiUnSubscribed: 成功取消订阅后调用的事件。
OnHuobiUpdate:每当数据(K 线、市场深度等)发生更新时,将调用此事件。
OnHuobiError:如果 Huobi API 出现错误,此事件将提供有关该错误的信息。