API Huobi

Huobi (HTX)

Huobi (ora rinominata HTX) è un exchange di criptovalute internazionale multilingua.

Configurazione

Se si desidera sottoscrivere agli aggiornamenti privati dell'account, è necessario creare una API Key nel proprio account Huobi. Una volta creata, impostare la API Key e il Secret nel client API Huobi

Se ApiKey non è vuota, il client tenterà di connettersi al server websocket privato e saranno disponibili solo i metodi privati. Se ApiKey è vuota, il client si connetterà al server websocket pubblico e saranno disponibili solo i metodi pubblici. Se è necessario sottoscriversi a metodi pubblici e privati, sono necessarie 2 connessioni.

Metodi pubblici

È possibile iscriversi ai seguenti canali pubblici (la chiave API non è necessaria)

Method Description
SubscribeKLine Questo topic invia una nuova candela ogni volta che è disponibile. Periodi supportati: 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1mon, 1week, 1year.
SubscribeMarketDepth Questo argomento invia il più recente libro degli ordini di mercato per prezzo in modalità snapshot a intervalli di 1 secondo. Livelli di aggregazione della profondità supportati: da step0 a step15.
SubscribeTradeDetail Questo argomento invia gli ultimi scambi completati. Si aggiorna tick per tick.
SubscribeMarketDetail

Questo topic invia le ultime statistiche di mercato con riepilogo 24h. Si aggiorna in modalità snapshot, con una frequenza non superiore a 10 volte al secondo.

SubscribeBBO L'utente può ricevere l'aggiornamento BBO (Best Bid/Offer) in modalità tick by tick.
SubscribeMarketTicker

Recuperare il ticker di mercato. I dati vengono inviati ogni 100 ms.

SubscribeMarketByPrice L'utente può iscriversi a questo canale per ricevere aggiornamenti del book degli ordini Market By Price. L'intervallo di aggiornamento è di circa 100 ms. Livelli supportati: 5, 10, 20, 150, 400.

Metodi pubblici Futures

I seguenti metodi sono disponibili per il client API Futures (TsgcWS_API_Huobi_Fut) in aggiunta a tutti i metodi pubblici sopra indicati.

Method Description
SubscribeIncrementalMarketDepth Sottoscrivi aggiornamenti incrementali della profondità di mercato con dimensione e tipo di dati configurabili (snapshot o incrementale).
SubscribePremiumIndexKLine Sottoscrivere i dati kline/candlestick premium dell'indice per i contratti futures.
SubscribeEstimatedRateKLine Iscriviti ai dati kline/candlestick del tasso di finanziamento stimato per i contratti futures.
SubscribeBasisData Sottoscriversi ai dati di base (spread di prezzo spot-futures). Supporta diversi tipi di prezzi di base: open, close, high, low.
SubscribeMarkPriceKLine Iscriviti ai dati kline/candlestick del prezzo mark per i contratti futures.
SubscribeLiquidationOrders Abbonati al feed degli ordini di liquidazione pubblica per un determinato contratto. Non è richiesta l'autenticazione.
SubscribeFundingRate Sottoscrivere gli aggiornamenti pubblici del tasso di finanziamento per un determinato contratto. Non è richiesta autenticazione.
SubscribeContractInfo Sottoscrive le modifiche dei parametri del contratto (ad esempio quotazioni, ritiri dalla quotazione, aggiustamenti dei parametri dei contratti).

Metodi privati

È possibile sottoscrivere i seguenti canali privati (è richiesta una chiave API). Se le credenziali non sono corrette, la connessione verrà chiusa automaticamente.

Method Description
SubscribeOrderUpdates

Un aggiornamento dell'ordine può essere attivato da uno dei seguenti eventi:


- Fallimento attivazione ordine condizionale (eventType=trigger)
- Cancellazione ordine condizionale prima dell'attivazione (eventType=deletion)
- Creazione ordine (eventType=creation)
- Corrispondenza ordine (eventType=trade)
- Cancellazione ordine (eventType=cancellation)

SubscribeTradeClearing Aggiornamento solo quando l'ordine è in transazione o in cancellazione. L'aggiornamento della transazione dell'ordine avviene in modalità tick by tick, il che significa che se l'ordine di un taker corrisponde a più ordini di maker, le più transazioni simultanee verranno diffuse una alla volta. Tuttavia, la sequenza di aggiornamento delle transazioni multiple potrebbe non corrispondere esattamente alla sequenza delle transazioni effettuate. Inoltre, se un ordine viene annullato automaticamente immediatamente dopo le sue esecuzioni parziali, come un tipico ordine IOC, questo canale potrebbe diffondere prima l'aggiornamento di cancellazione rispetto alla transazione.
SubscribeAccountChange

Specificato il campo di sottoscrizione, l'aggiornamento può essere attivato da uno dei seguenti eventi. Il parametro aMode controlla il comportamento dell'aggiornamento:

Modalità 0: aggiorna solo quando il saldo del conto viene modificato.

Modalità 1: aggiornamento quando il saldo del conto o il saldo disponibile cambia (aggiornamenti separati).

Modalità 2: aggiornamento quando il saldo del conto o il saldo disponibile cambia (aggiornamento combinato).

Eventi

OnHuobiSubscribed: evento chiamato dopo una sottoscrizione avvenuta con successo.

OnHuobiUnSubscribed: evento chiamato dopo una cancellazione della sottoscrizione avvenuta con successo.

OnHuobiUpdate: ogni volta che c'è un aggiornamento nei dati (kline, market depth...) viene chiamato questo evento.

OnHuobiError: se si verifica un errore nell'API Huobi, questo evento fornirà informazioni sull'errore.