Huobi (przemianowany na HTX) to międzynarodowa wielojęzyczna giełda kryptowalut.
Aby subskrybować prywatne aktualizacje konta, należy utworzyć klucz API na koncie Huobi. Po utworzeniu należy ustawić klucz API i sekret w kliencie Huobi API
Jeśli ApiKey nie jest pusty, klient spróbuje połączyć się z prywatnym serwerem WebSocket i dostępne będą wyłącznie metody prywatne. Jeśli ApiKey jest pusty, klient połączy się z publicznym serwerem WebSocket i dostępne będą wyłącznie metody publiczne. Jeśli potrzebna jest subskrypcja zarówno metod publicznych, jak i prywatnych, wymagane są 2 połączenia.
Można subskrybować następujące kanały publiczne (klucz API nie jest wymagany).
| Metoda | Opis |
| SubscribeKLine | Ten temat wysyła nową świecę, gdy tylko jest dostępna. Obsługiwane okresy: 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1mon, 1week, 1year. |
| SubscribeMarketDepth | Ten temat wysyła najnowszy arkusz zleceń według ceny w trybie migawki w odstępach 1-sekundowych. Obsługiwane poziomy agregacji głębokości: od step0 do step15. |
| SubscribeTradeDetail | Ten temat wysyła najnowsze zakończone transakcje. Aktualizowany jest w trybie tick by tick. |
| SubscribeMarketDetail |
Ten temat przesyła najnowsze statystyki rynkowe z podsumowaniem 24-godzinnym. Aktualizowany jest w trybie snapshot z częstotliwością nie większą niż 10 razy na sekundę. |
| SubscribeBBO | Użytkownik może otrzymywać aktualizacje BBO (Best Bid/Offer) w trybie tick-by-tick. |
| SubscribeMarketTicker |
Pobieranie tickera rynkowego. Dane są przekazywane co 100 ms. |
| SubscribeMarketByPrice | Użytkownik może subskrybować ten kanał, aby otrzymywać aktualizacje arkusza zleceń Market By Price. Interwał aktualizacji wynosi około 100 ms. Obsługiwane poziomy: 5, 10, 20, 150, 400. |
Następujące metody są dostępne dla klienta Futures API (TsgcWS_API_Huobi_Fut) jako uzupełnienie wszystkich wymienionych powyżej metod publicznych.
| Metoda | Opis |
| SubscribeIncrementalMarketDepth | Subskrybuj przyrostowe aktualizacje głębokości rynku z konfigurowalnym rozmiarem i typem danych (migawka lub przyrostowa). |
| SubscribePremiumIndexKLine | Subskrybuj dane kline/świecznikowe indeksu premium dla kontraktów futures. |
| SubscribeEstimatedRateKLine | Subskrybuje dane kline/świecowe szacowanej stopy finansowania dla kontraktów futures. |
| SubscribeBasisData | Subskrypcja danych bazowych (spread cenowy spot-futures). Obsługuje różne typy cen bazowych: open, close, high, low. |
| SubscribeMarkPriceKLine | Subskrybuje dane kline/świecowe ceny mark dla kontraktów futures. |
| SubscribeLiquidationOrders | Subskrybuj publiczny feed zleceń likwidacyjnych dla danego kontraktu. Uwierzytelnianie nie jest wymagane. |
| SubscribeFundingRate | Subskrybuj publiczne aktualizacje stopy finansowania dla danego kontraktu. Uwierzytelnianie nie jest wymagane. |
| SubscribeContractInfo | Subskrybuj zmiany parametrów kontraktu (np. notowania kontraktów, usunięcia z notowań, korekty parametrów). |
Można subskrybować następujące kanały prywatne (wymagany jest klucz API). Jeśli dane uwierzytelniające są nieprawidłowe, połączenie zostanie automatycznie zamknięte.
| Metoda | Opis |
| SubscribeOrderUpdates |
Aktualizacja zamówienia może zostać wywołana przez dowolne z poniższych zdarzeń:
|
| SubscribeTradeClearing | Aktualizacja następuje wyłącznie, gdy zlecenie jest w trakcie transakcji lub anulowania. Aktualizacja transakcji zlecenia odbywa się w trybie tick-by-tick, co oznacza, że jeśli zlecenie biorącego (taker) pasuje do wielu zleceń dającego (maker), jednoczesne wielokrotne transakcje są przesyłane jedna po drugiej. Kolejność aktualizacji wielu transakcji może jednak nie być dokładnie taka sama jak kolejność wykonanych transakcji. Ponadto, jeśli zlecenie zostanie automatycznie anulowane natychmiast po częściowym realizowaniu — na przykład typowe zlecenie IOC — ten kanał może najpierw przesłać aktualizację anulowania przed informacją o transakcji. |
| SubscribeAccountChange |
Po określeniu wartości pola subskrypcji aktualizacja może być wyzwalana przez dowolne z następujących zdarzeń. Parametr aMode steruje zachowaniem aktualizacji:
Tryb 0: Aktualizacja tylko w przypadku zmiany salda konta. Tryb 1: Aktualizacja przy zmianie salda konta lub dostępnego salda (oddzielne aktualizacje). Tryb 2: Aktualizacja przy zmianie salda konta lub dostępnego salda (aktualizacja łączona). |
OnHuobiSubscribed: zdarzenie wywoływane po pomyślnej subskrypcji.
OnHuobiUnSubscribed: zdarzenie wywoływane po pomyślnym anulowaniu subskrypcji.
OnHuobiUpdate: zdarzenie wywoływane przy każdej aktualizacji danych (kline, głębokość rynku itp.).
OnHuobiError: jeśli wystąpi błąd w API Huobi, to zdarzenie dostarczy informacje o błędzie.