API Huobi

Huobi (HTX)

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

订单更新可由以下任一情况触发:


- 条件订单触发失败(eventType=trigger)
- 触发前取消条件订单(eventType=deletion)
- 订单创建(eventType=creation)
- 订单成交(eventType=trade)
- 订单取消(eventType=cancellation)

SubscribeTradeClearing 仅在订单处于交易中或取消时更新。订单交易更新为逐笔模式,这意味着如果吃单方的订单与多个挂单方的订单匹配,则同时发生的多笔交易将逐一推送。但多笔交易的更新顺序可能与实际交易顺序不完全一致。此外,如果订单在部分成交后立即被自动取消(例如典型的 IOC 订单),该频道可能会在交易推送之前先推送取消更新。
SubscribeAccountChange

订阅字段值指定后,更新可由以下任一事件触发。aMode 参数控制更新行为:

模式 0:仅在账户余额变化时更新。

模式 1:当账户余额或可用余额发生变化时更新(分别更新)。

模式 2:当账户余额或可用余额发生变化时更新(合并更新)。

事件

OnHuobiSubscribed:订阅成功后调用的事件。

OnHuobiUnSubscribed: 成功取消订阅后调用的事件。

OnHuobiUpdate:每当数据(K 线、市场深度等)发生更新时,将调用此事件。

OnHuobiError:如果 Huobi API 出现错误,此事件将提供有关该错误的信息。