Huobi(현재 HTX로 브랜드 변경됨)는 국제 다국어 암호화폐 거래소입니다.
private 계정 업데이트를 구독하려면, Huobi 계정에서 API Key를 생성해야 합니다. 생성되면 Huobi API Client에 API Key와 Secret를 설정하십시오
ApiKey가 비어 있지 않으면 클라이언트는 프라이빗 websocket 서버에 연결을 시도하므로 프라이빗 메서드만 사용할 수 있습니다. ApiKey가 비어 있으면 클라이언트는 공개 websocket 서버에 연결하며 공개 메서드만 사용할 수 있습니다. 공개 및 프라이빗 메서드를 모두 구독해야 하는 경우 2개의 연결이 필요합니다.
다음 공개 채널을 구독할 수 있습니다(api key 불필요).
| 메서드 | 설명 |
| SubscribeKLine | 이 토픽은 사용 가능할 때마다 새 캔들스틱을 보냅니다. 지원되는 기간: 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1mon, 1week, 1year. |
| SubscribeMarketDepth | 이 토픽은 1초 간격으로 스냅샷 모드에서 가격순 최신 시장 호가창을 전송합니다. 지원되는 깊이 집계 수준: step0부터 step15까지. |
| SubscribeTradeDetail | 이 토픽은 가장 최근에 완료된 거래를 보냅니다. tick by tick 모드로 업데이트됩니다. |
| SubscribeMarketDetail |
이 토픽은 24시간 요약과 함께 최신 시장 통계를 전송합니다. 초당 10회를 넘지 않는 빈도로 스냅샷 모드에서 업데이트됩니다 |
| SubscribeBBO | 사용자는 tick by tick 모드로 BBO(Best Bid/Offer) 업데이트를 받을 수 있습니다. |
| SubscribeMarketTicker |
시장 티커를 검색합니다. 데이터는 100ms마다 푸시됩니다. |
| SubscribeMarketByPrice | 사용자는 이 채널을 구독하여 Market By Price order book의 새로 고침 업데이트를 받을 수 있습니다. 업데이트 간격은 약 100ms입니다. 지원되는 level: 5, 10, 20, 150, 400. |
위의 모든 공개 메서드 외에 Futures API 클라이언트(TsgcWS_API_Huobi_Fut)에 대해 다음 메서드를 사용할 수 있습니다.
| 메서드 | 설명 |
| SubscribeIncrementalMarketDepth | 구성 가능한 크기 및 데이터 유형(스냅샷 또는 증분)으로 증분 시장 깊이 업데이트를 구독합니다. |
| SubscribePremiumIndexKLine | 선물 계약에 대한 프리미엄 인덱스 캔들스틱 데이터를 구독합니다. |
| SubscribeEstimatedRateKLine | 선물 계약에 대한 예상 funding rate kline/candlestick 데이터를 구독합니다. |
| SubscribeBasisData | basis 데이터(spot-futures 가격 스프레드)를 구독합니다. 다양한 basis 가격 유형을 지원합니다: open, close, high, low. |
| SubscribeMarkPriceKLine | 선물 계약에 대한 mark price kline/candlestick 데이터를 구독합니다. |
| SubscribeLiquidationOrders | 주어진 계약에 대한 public liquidation order 피드를 구독합니다. 인증이 필요하지 않습니다. |
| SubscribeFundingRate | 지정된 계약에 대한 공개 펀딩 비율 업데이트를 구독합니다. 인증이 필요하지 않습니다. |
| SubscribeContractInfo | 계약 매개변수 변경(예: 계약 상장, 상장 폐지, 매개변수 조정)을 구독합니다. |
다음 private 채널을 구독할 수 있습니다(api key 필요). 자격 증명이 올바르지 않으면 연결이 자동으로 닫힙니다.
| 메서드 | 설명 |
| SubscribeOrderUpdates |
주문 업데이트는 다음 중 하나에 의해 트리거될 수 있습니다:
|
| SubscribeTradeClearing | 주문이 거래 중이거나 취소 중일 때만 업데이트됩니다. 주문 거래 업데이트는 tick by tick 모드로, 이는 taker의 주문이 여러 maker의 주문과 일치하면 동시의 여러 거래가 하나씩 전파됨을 의미합니다. 그러나 여러 거래의 업데이트 순서는 실제로 이루어진 거래의 순서와 정확히 같지 않을 수 있습니다. 또한 주문이 부분 체결 직후 자동 취소되는 경우, 예를 들어 일반적인 IOC 주문의 경우, 이 채널은 거래보다 취소 업데이트를 먼저 전파할 수 있습니다. |
| SubscribeAccountChange |
구독 시 지정된 필드 값에 따라, 업데이트는 다음 이벤트 중 하나에 의해 트리거될 수 있습니다. aMode 매개변수는 업데이트 동작을 제어합니다:
Mode 0: 계정 잔액이 변경될 때만 업데이트합니다. 모드 1: 계정 잔액 또는 사용 가능 잔액 중 하나가 변경될 때 업데이트(별도 업데이트). 모드 2: 계정 잔액 또는 사용 가능 잔액이 변경될 때 업데이트(결합된 업데이트). |
OnHuobiSubscribed: 구독 성공 후 호출되는 이벤트입니다.
OnHuobiUnSubscribed: 구독 취소에 성공한 후 호출되는 이벤트입니다.
OnHuobiUpdate: 데이터(kline, market depth...)에 업데이트가 있을 때마다 이 이벤트가 호출됩니다.
OnHuobiError: Huobi API에 오류가 있는 경우 이 이벤트가 오류에 대한 정보를 제공합니다.