API
REST API WebSocket Python SDK

HTX交易所
量化交易
API完全指南

面向开发者与量化交易员的HTX交易所API接入手册。覆盖REST与WebSocket双协议架构、HMAC-SHA256签名认证、高频做市策略,助你构建专业级算法交易系统。

开始接入 → 策略模板 →
# HTX交易所 REST API 快速示例 import hmac, hashlib, requests from datetime import datetime API_KEY = "your-api-key" SECRET = "your-secret-key" BASE = "https://api.huobi.pro" def get_ticker(symbol): r = requests.get( f"{BASE}/market/detail/merged", params={"symbol": symbol} ) data = r.json()["tick"] return { "bid": data["bid"][0], "ask": data["ask"][0], "vol": data["vol"] } ticker = get_ticker("btcusdt") print(f"BTC/USDT 买一: {ticker['bid']}")
REST

API架构概览:REST vs WebSocket

HTX交易所提供两种核心协议接入方式。REST API适用于订单管理、账户查询等请求-响应模式;WebSocket API适用于实时行情推送与订单状态订阅,无需轮询。

01

REST API

基于HTTPS的请求-响应协议,适用于订单创建、撤销、余额查询、历史交易记录获取等操作。所有写入操作必须使用HMAC-SHA256签名认证。

  • 端点:api.huobi.pro
  • 速率限制:200 req/s
  • 认证:HMAC-SHA256 + Timestamp
  • 格式:JSON
02

WebSocket API

全双工实时通信协议,支持市场行情、K线、深度数据和订单更新的订阅推送。连接建立后数据零延迟推送,无需反复请求。

  • 端点:wss://api.huobi.pro/ws
  • 速率限制:无限制(推送模式)
  • 心跳:Ping/Pong 每20s
  • 压缩:GZIP
AUTH

认证流程:HMAC-SHA256签名

HTX交易所API所有私有端点均需要HMAC-SHA256签名认证。签名过程包含请求方法、主机名、路径、UTC时间戳和请求参数的规范化拼接。

①

构建签名字符串

将HTTP方法、API主机、请求路径和排序后的查询参数用换行符拼接。时间戳格式为YYYY-MM-DDTHH:MM:SS。

②

HMAC-SHA256加密

使用Secret Key对签名字符串进行HMAC-SHA256哈希运算,结果进行Base64编码。得到的字符串即为Signature参数值。

③

附加至请求

将AccessKeyId、SignatureMethod、SignatureVersion、Timestamp和Signature作为查询参数附加到请求URL,发送至HTX交易所服务端验证。

# HTX交易所签名认证 Python实现 import hmac, hashlib, base64, urllib.parse from datetime import datetime, timezone def sign_request(method, host, path, params, secret): sorted_params = urllib.parse.urlencode( sorted(params.items()) ) payload = f"{method}\n{host}\n{path}\n{sorted_params}" digest = hmac.new( secret.encode('utf-8'), payload.encode('utf-8'), hashlib.sha256 ).digest() return base64.b64encode(digest).decode() # 使用示例 params = { "AccessKeyId": API_KEY, "SignatureMethod": "HmacSHA256", "SignatureVersion": "2", "Timestamp": datetime.now(timezone.utc) .strftime("%Y-%m-%dT%H:%M:%S") } sig = sign_request("GET", "api.huobi.pro", "/v1/account/accounts", params, SECRET)

速率限制与接口配额

HTX交易所对不同API端点设置了差异化速率限制策略,高频交易者可通过VIP等级获得更高配额。

接口类型默认限制VIP限制超限响应
REST 行情接口200 req/s500 req/s429 Too Many Requests
REST 交易接口100 req/s300 req/s429 Too Many Requests
REST 账户接口50 req/s100 req/s429 Too Many Requests
WebSocket 订阅无限制无限制推送模式 — 服务端主动推送
WebSocket 请求50 req/s100 req/s连接断开
QUANT

四大量化策略类型

HTX交易所API支持多种量化交易策略的自动化执行,以下是最受开发者欢迎的四种策略范式。

01

网格交易

在预设价格区间内按等差或等比间隔自动挂单,低买高卖捕捉震荡行情利润。适合横盘市场。

GRID BOT
02

DCA定投

按固定时间间隔和金额自动买入,利用时间加权平均成本法降低持仓均价。适合长期投资者。

DCA BOT
03

跨所套利

监控HTX交易所与其他交易所同一交易对的价差,当价差超过阈值时自动执行买卖操作锁定无风险利润。

ARBITRAGE
04

做市策略

在买卖两侧持续挂单提供流动性,通过买卖价差(Spread)获利。HTX交易所为做市商提供VIP费率优惠。

MARKET MAKING

做市商VIP费率优惠

HTX交易所为API交易量达标的量化交易者提供阶梯式费率减免,做市商(Maker)可享受负手续费返佣。

VIP等级30日交易量 (USDT)Maker费率Taker费率API速率倍数
普通用户< 1,000,0000.20%0.20%1×
VIP 1≥ 1,000,0000.18%0.19%1.5×
VIP 3≥ 10,000,0000.12%0.15%2×
VIP 5≥ 50,000,0000.06%0.10%3×
做市商 MM审核制-0.01%0.04%5×

* 做市商负费率表示交易所向Maker返还手续费,鼓励提供流动性。申请需联系HTX交易所商务团队。

WebSocket 实时行情订阅示例

以下Python代码演示如何通过WebSocket连接HTX交易所实时行情接口,订阅BTC/USDT深度数据并自动处理GZIP解压与心跳响应。

# HTX交易所 WebSocket 深度数据订阅 import websocket, json, gzip def on_message(ws, message): data = json.loads( gzip.decompress(message).decode('utf-8') ) # 处理心跳 if "ping" in data: ws.send(json.dumps({"pong": data["ping"]})) return # 处理行情数据 tick = data.get("tick", {}) bids = tick.get("bids", [])[:5] asks = tick.get("asks", [])[:5] print(f"买盘前5: {bids}") print(f"卖盘前5: {asks}") def on_open(ws): ws.send(json.dumps({ "sub": "market.btcusdt.depth.step0", "id": "depth_btcusdt" })) ws = websocket.WebSocketApp( "wss://api.huobi.pro/ws", on_message=on_message, on_open=on_open ) ws.run_forever()

开始构建你的量化交易系统

从HTX交易所Python SDK安装开始,10分钟搭建你的第一个交易机器人。

下载SDK → 策略模板 →