SDK
Python 3.10+ pip install Docker

HTX交易所下载
Python SDK
环境搭建

从零开始搭建HTX交易所量化交易开发环境。安装Python SDK、配置API密钥、连接沙盒测试网,5分钟启动你的第一个交易脚本。

PIP
01

安装HTX交易所Python SDK

HTX交易所官方Python SDK通过pip包管理器安装。推荐使用虚拟环境隔离交易项目依赖,避免版本冲突。SDK包含REST客户端、WebSocket客户端和签名工具。

系统要求:Python 3.10+,pip 22.0+,推荐使用Linux/macOS生产环境。

# 创建虚拟环境 python -m venv htx-trading source htx-trading/bin/activate # 安装HTX交易所SDK及依赖 pip install htx-sdk pip install websocket-client requests pandas # 验证安装 python -c "import htx; print(htx.__version__)" # 输出: 2.4.1 # 可选:安装技术分析库 pip install ta-lib numpy scipy
02

API密钥生成与配置

登录HTX交易所账户后,在「API管理」页面创建新的API密钥对。务必为密钥设置适当的权限范围和IP白名单限制。

密钥生成步骤

  1. 登录HTX交易所 → 「个人中心」→「API管理」
  2. 点击「创建API密钥」,填写备注名称
  3. 选择权限:只读 / 交易 / 提现
  4. 绑定IP白名单(强烈推荐)
  5. 完成二次验证后获取 Access Key 和 Secret Key
  6. Secret Key 仅显示一次,立即保存至安全位置
# config.py — HTX交易所API配置文件 import os # 从环境变量读取密钥(推荐) HTX_CONFIG = { "access_key": os.getenv("HTX_ACCESS_KEY"), "secret_key": os.getenv("HTX_SECRET_KEY"), "host": "api.huobi.pro", "ws_host": "wss://api.huobi.pro/ws", } # 沙盒/测试网配置 HTX_SANDBOX = { "access_key": os.getenv("HTX_SANDBOX_KEY"), "secret_key": os.getenv("HTX_SANDBOX_SECRET"), "host": "api.testnet.huobi.pro", "ws_host": "wss://api.testnet.huobi.pro/ws", } # .env 文件示例 # HTX_ACCESS_KEY=your-access-key-here # HTX_SECRET_KEY=your-secret-key-here
# 设置环境变量 (Linux/macOS) export HTX_ACCESS_KEY="abc123..." export HTX_SECRET_KEY="xyz789..." # 或使用 .env 文件 + python-dotenv pip install python-dotenv
03

沙盒测试网配置

HTX交易所提供Testnet沙盒环境,允许开发者使用模拟资金测试交易策略,无需承担真实资金风险。沙盒环境支持所有主流交易对。

①

注册测试账号

访问HTX交易所测试网站点注册专用测试账号,获取沙盒API密钥对。测试账号预充100 BTC和1,000,000 USDT模拟资金。

②

切换API端点

将REST端点从 api.huobi.pro 替换为 api.testnet.huobi.pro。WebSocket端点同理替换。

③

验证连通性

运行测试脚本确认API连接正常,检查余额接口返回模拟资金数据。确认无误后逐步迁移至主网。

04

IDE与开发工具推荐

高效的量化开发需要合适的IDE配置。以下是HTX交易所API开发推荐的工具链和插件。

推荐IDE

  • VS Code — 轻量级,丰富的Python插件生态
  • PyCharm — 专业Python IDE,调试功能强大
  • Jupyter Lab — 适合策略回测与数据可视化
  • Vim + tmux — 服务器端远程开发首选

推荐VS Code插件

  • Python — Microsoft官方Python支持
  • Pylance — 类型检查与智能补全
  • REST Client — API接口快速测试
  • Thunder Client — 轻量级API调试
05

Docker容器化交易机器人

使用Docker将HTX交易所交易机器人打包为独立容器,确保生产环境一致性与快速部署能力。

# Dockerfile — HTX交易所交易机器人 FROM python:3.11-slim WORKDIR /app # 安装依赖 COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt # 复制交易策略代码 COPY src/ ./src/ COPY config.py . # 环境变量(运行时通过 -e 传入) ENV HTX_ACCESS_KEY="" ENV HTX_SECRET_KEY="" ENV TRADING_MODE="sandbox" # 启动交易机器人 CMD ["python", "src/bot.py"]
# 构建和运行 docker build -t htx-bot . docker run -d \ --name htx-grid-bot \ -e HTX_ACCESS_KEY="your-key" \ -e HTX_SECRET_KEY="your-secret" \ -e TRADING_MODE="production" \ --restart unless-stopped \ htx-bot

环境搭建完成,下一步?

探索HTX交易所网格交易策略模板,或查阅API安全配置最佳实践。

策略模板 → 安全配置 →