API Huobi

Huobi (HTX)

A Huobi (agora renomeada como HTX) é uma exchange de criptomoedas internacional e multilíngue.

Configuração

Se você quiser assinar as atualizações privadas da conta, precisa criar uma API Key em sua conta Huobi. Uma vez criada, defina a API Key e o Secret no Huobi API Client

Se a ApiKey não estiver vazia, o cliente tentará conectar ao servidor websocket privado, então apenas os métodos privados estarão disponíveis. Se a ApiKey estiver vazia, o cliente conectará ao servidor websocket público e apenas os métodos públicos estarão disponíveis. Se você precisar assinar métodos públicos e privados, precisará de 2 conexões.

Métodos Públicos

Você pode assinar os seguintes canais públicos (a api key não é obrigatória)

Method Descrição
SubscribeKLine Este tópico envia um novo candlestick sempre que ele estiver disponível. Períodos suportados: 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1mon, 1week, 1year.
SubscribeMarketDepth Este tópico envia o order book mais recente por preço de mercado em modo snapshot a intervalos de 1 segundo. Níveis de agregação de profundidade suportados: step0 a step15.
SubscribeTradeDetail Este tópico envia as negociações concluídas mais recentes. Ele atualiza no modo tick a tick.
SubscribeMarketDetail

Este tópico envia as estatísticas de mercado mais recentes com resumo de 24h. Ele é atualizado em modo de snapshot, a uma frequência de no máximo 10 vezes por segundo

SubscribeBBO O usuário pode receber atualizações de BBO (Best Bid/Offer) em modo tick a tick.
SubscribeMarketTicker

Recupera o ticker de mercado. Os dados são enviados a cada 100ms.

SubscribeMarketByPrice O usuário pode fazer subscribe a este canal para receber atualizações de refresh do order book Market By Price. O intervalo de atualização é de cerca de 100ms. Níveis suportados: 5, 10, 20, 150, 400.

Futures Public Methods

Os seguintes métodos estão disponíveis para o cliente da Futures API (TsgcWS_API_Huobi_Fut), além de todos os métodos públicos acima.

Method Descrição
SubscribeIncrementalMarketDepth Assina atualizações incrementais de profundidade de mercado com tamanho e tipo de dados configuráveis (snapshot ou incremental).
SubscribePremiumIndexKLine Assine os dados de premium index kline/candlestick para contratos de futuros.
SubscribeEstimatedRateKLine Faça subscribe a dados de kline/candlestick de taxa de funding estimada para contratos de futuros.
SubscribeBasisData Assine os dados de basis (spread de preço spot-futures). Suporta diferentes tipos de basis price: open, close, high, low.
SubscribeMarkPriceKLine Faça subscribe a dados de kline/candlestick de mark price para contratos de futuros.
SubscribeLiquidationOrders Assina o feed público de ordens de liquidação de um determinado contrato. Nenhuma autenticação necessária.
SubscribeFundingRate Assine atualizações públicas de funding rate para um contrato informado. Nenhuma autenticação necessária.
SubscribeContractInfo Assinar mudanças de parâmetros de contrato (por exemplo, listagens de contratos, deslistagens, ajustes de parâmetros).

Métodos privados

Você pode assinar os seguintes canais privados (uma api key é necessária). Se as credenciais não estiverem corretas, a conexão será fechada automaticamente.

Method Descrição
SubscribeOrderUpdates

Uma atualização de ordem pode ser acionada por qualquer um dos seguintes:


- Falha no acionamento de ordem condicional (eventType=trigger)
- Cancelamento de ordem condicional antes do acionamento (eventType=deletion)
- Criação de ordem (eventType=creation)
- Correspondência de ordem (eventType=trade)
- Cancelamento de ordem (eventType=cancellation)

SubscribeTradeClearing Atualize apenas quando a ordem estiver em transação ou cancelamento. A atualização da transação da ordem ocorre no modo tick by tick, o que significa que, se a ordem de um taker corresponder a múltiplas ordens de makers, os múltiplos trades simultâneos serão disseminados um a um. Porém, a sequência de atualização dos múltiplos trades pode não ser exatamente a mesma que a sequência das transações realizadas. Além disso, se uma ordem for cancelada automaticamente imediatamente após seus preenchimentos parciais, por exemplo uma ordem IOC típica, este canal poderia possivelmente disseminar a atualização de cancelamento antes do trade.
SubscribeAccountChange

Após o valor do campo de assinatura especificado, a atualização pode ser disparada por qualquer um dos seguintes eventos. O parâmetro aMode controla o comportamento da atualização:

Mode 0: Atualizar apenas quando o saldo da conta for alterado.

Modo 1: Atualiza quando o saldo da conta ou o saldo disponível é alterado (atualizações separadas).

Modo 2: Atualiza quando o saldo da conta ou o saldo disponível é alterado (atualização combinada).

Eventos

OnHuobiSubscribed: evento chamado após uma assinatura bem-sucedida.

OnHuobiUnSubscribed: evento chamado após uma desinscrição bem-sucedida.

OnHuobiUpdate: toda vez que há uma atualização nos dados (kline, market depth...) este evento é chamado.

OnHuobiError: se houver um erro na API da Huobi, este evento fornecerá informações sobre o erro.