HTX(이전 Huobi) API 업데이트 sgcWebSockets

2026년 3월 2일 · 기능

sgcWebSockets for Delphi의 Huobi(HTX) WebSocket API 컴포넌트에 중요한 업데이트를 알려 드리게 되어 기뻐요. 이번 업데이트는 확장된 시장 데이터 지원, 새로운 선물 전용 구독 채널, 개선된 매개변수 옵션을 제공해 여러분의 트레이딩 애플리케이션이 최신 HTX 거래소 기능과 최신 상태를 유지할 수 있게 해줘요.

새로운 기능

확장된 KLine 기간

KLine(캔들스틱) 구독이 이제 기술 분석에서 가장 일반적으로 사용되는 타임프레임 중 하나인 4시간 기간 (hup4Hour)을 지원해요. 지원되는 기간의 전체 목록: 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1week, 1mon, 1year.

확장된 시장 깊이 집계 수준

시장 깊이 구독이 이제 step0에서 step15까지 집계 수준을 지원해요(이전에는 step0-step5만 지원). 이를 통해 오더북 데이터 세분성을 더 정밀하게 제어할 수 있어요.

새로운 가격별 시장 수준

가격별 시장(MBP) 구독이 이제 기존 5, 10, 20 수준에 더해 150 및 400 수준으로 더 깊은 오더북 보기를 지원해요.

개선된 SubscribeAccountChange

SubscribeAccountChange 메서드가 이제 업데이트 동작을 제어하는 aMode 매개변수를 받아요:

Mode	설명
`0`	계정 잔액이 변경될 때만 업데이트해요.
`1`	계정 잔액 또는 사용 가능한 잔액이 변경될 때 업데이트해요(별도 업데이트).
`2`	계정 잔액 또는 사용 가능한 잔액이 변경될 때 업데이트해요(통합 업데이트).

새로운 선물 구독 메서드

선물 API 클라이언트(TsgcWS_API_Huobi_Fut)에 선물 전용 시장 데이터를 위한 7가지 새 구독 채널이 추가되었어요:

메서드	설명
`SubscribePremiumIndexKLine`	선물 계약의 프리미엄 인덱스 kline/캔들스틱 데이터를 구독해요.
`SubscribeEstimatedRateKLine`	선물 계약의 예상 펀딩 레이트 kline 데이터를 구독해요.
`SubscribeBasisData`	기초 데이터(현물-선물 가격 스프레드)를 구독해요. 지원 가격 유형: open, close, high, low.
`SubscribeMarkPriceKLine`	선물 계약의 마크 가격 kline/캔들스틱 데이터를 구독해요.
`SubscribeLiquidationOrders`	공개 청산 주문 피드를 구독해요. 인증이 필요 없어요.
`SubscribeFundingRate`	특정 계약의 공개 펀딩 레이트 업데이트를 구독해요.
`SubscribeContractInfo`	계약 매개변수 변경(상장, 상장 폐지, 조정)을 구독해요.

코드 예제

// Subscribe to 4-hour kline for BTC/USDT
sgcWSHuobi1.SubscribeKLine('btcusdt', hup4Hour);
// Subscribe to deeper order book (150 levels)
sgcWSHuobi1.SubscribeMarketByPrice('btcusdt', hulLevel150);
// Subscribe to account changes with mode 1
sgcWSHuobi1.SubscribeAccountChange(1);
// Futures: Subscribe to mark price kline
sgcWSHuobiFut1.SubscribeMarkPriceKLine('BTC-USD', hup1Min);
// Futures: Subscribe to liquidation orders
sgcWSHuobiFut1.SubscribeLiquidationOrders('BTC-USD');
// Futures: Subscribe to basis data with close price type
sgcWSHuobiFut1.SubscribeBasisData('BTC_CQ', hup1Min, hbpClose);
// Futures: Subscribe to funding rate
sgcWSHuobiFut1.SubscribeFundingRate('BTC-USD');

호환성

모든 변경 사항은 하위 호환성이 있어요. 기존 코드는 수정 없이 계속 작동해요. WebSocket 엔드포인트는 변경되지 않았어요(공개 데이터는 wss://api.huobi.pro/ws, 인증된 채널은 wss://api.huobi.pro/ws/v2). 인증 방법(HmacSHA256 v2.1)도 변경되지 않았어요.

참고: 이 업데이트는 sgcWebSockets 2026.3.0에서 사용할 수 있어요.

목차