API Huobi

Huobi (HTX)

Huobi(現在 HTX にリブランド)は国際的な多言語対応の暗号通貨取引所です。

設定

プライベートアカウントの更新をサブスクライブするには、Huobi アカウントで API キーを作成する必要があります。作成後、Huobi API クライアントに API キーとシークレットを設定してください

ApiKey が空でない場合、クライアントはプライベート WebSocket サーバーへの接続を試み、プライベートメソッドのみが利用可能になります。ApiKey が空の場合、クライアントはパブリック WebSocket サーバーに接続し、パブリックメソッドのみが利用可能になります。パブリックメソッドとプライベートメソッドの両方をサブスクライブする必要がある場合は、2 つの接続が必要です。

パブリックメソッド

以下のパブリックチャンネルをサブスクライブできます(API キーは不要)

メソッド 説明
SubscribeKLine このトピックは利用可能になると新しいローソク足を送信します。対応期間:1min、5min、15min、30min、60min、4hour、1day、1mon、1week、1year。
SubscribeMarketDepth このトピックは、最新のmarket by price板を、1秒間隔のスナップショットモードで送信します。サポートされる深さの集約レベル: step0 から step15 まで。
SubscribeTradeDetail このトピックは最新の完了した取引を送信します。ティックごとのモードで更新されます。
SubscribeMarketDetail

このトピックは 24 時間のサマリーを含む最新の市場統計を送信します。1 秒間に最大 10 回の頻度でスナップショットモードで更新されます。

SubscribeBBO ユーザーはティックバイティックモードで BBO(Best Bid/Offer)の更新を受け取ることができます。
SubscribeMarketTicker

マーケットティッカーを取得します。データは 100ms ごとにプッシュされます。

SubscribeMarketByPrice このチャンネルをサブスクライブして Market By Price 注文板のリフレッシュ更新を受信します。更新間隔は約 100ms です。サポートされているレベル: 5、10、20、150、400。

Futures パブリックメソッド

以下のメソッドは、上記のすべてのパブリックメソッドに加えて、Futures APIクライアント(TsgcWS_API_Huobi_Fut)で使用できます。

メソッド 説明
SubscribeIncrementalMarketDepth 設定可能なサイズとデータタイプ (スナップショットまたはインクリメンタル) でインクリメンタルな市場深度の更新をサブスクライブします。
SubscribePremiumIndexKLine 先物契約のプレミアムインデックスのローソク足データを購読します。
SubscribeEstimatedRateKLine 先物コントラクトの推定資金調達レートのローソク足/ライン データをサブスクライブします。
SubscribeBasisData ベーシスデータ(スポットと先物の価格差)にサブスクライブします。open、close、high、low など異なるベーシス価格タイプをサポートします。
SubscribeMarkPriceKLine 先物コントラクトのマーク価格ローソク足/ライン データをサブスクライブします。
SubscribeLiquidationOrders 指定したコントラクトのパブリック清算注文フィードをサブスクライブします。認証は不要です。
SubscribeFundingRate 指定した契約のパブリックなファンディングレート更新にサブスクライブします。認証は不要です。
SubscribeContractInfo 契約パラメーターの変更(例:契約の上場、上場廃止、パラメーター調整)をサブスクライブします。

Private メソッド

以下のプライベートチャンネルにサブスクライブできます(API キーが必要です)。資格情報が正しくない場合、接続は自動的に切断されます。

メソッド 説明
SubscribeOrderUpdates

注文の更新は次のいずれかによってトリガーされる可能性があります:


- 条件付き注文のトリガー失敗(eventType=trigger)
- トリガー前の条件付き注文のキャンセル(eventType=deletion)
- 注文作成(eventType=creation)
- 注文マッチング(eventType=trade)
- 注文キャンセル(eventType=cancellation)

SubscribeTradeClearing 注文がトランザクション中またはキャンセル中の場合のみ更新されます。注文トランザクションの更新はティックバイティックモードです。つまり、テイカーの注文が複数のメーカーの注文と一致した場合、同時に発生した複数のトレードは 1 つずつ配信されます。ただし、複数のトレードの更新シーケンスは、トランザクションが行われた順序とまったく同じでない場合があります。また、注文が部分約定直後に自動キャンセルされた場合(例: 典型的な IOC 注文)、このチャンネルがトレードの前にキャンセルの更新を先に配信する可能性があります。
SubscribeAccountChange

サブスクリプションフィールドの値が指定されると、次のいずれかのイベントによって更新がトリガーされます。aMode パラメーターは更新動作を制御します:

モード 0:アカウント残高が変更された場合のみ更新します。

モード1: アカウント残高または利用可能残高のいずれかが変更されたときに更新します(個別更新)。

モード2: アカウント残高または利用可能残高が変更されたときに更新します(複合更新)。

イベント

OnHuobiSubscribed: サブスクリプションが成功した後に呼び出されるイベントです。

OnHuobiUnSubscribed: サブスクリプション解除が成功した後に呼び出されるイベント。

OnHuobiUpdate: データ(Kライン、市場の深さなど)が更新されるたびにこのイベントが呼び出されます。

OnHuobiError: Huobi API にエラーが発生した場合、このイベントはエラーに関する情報を提供します。