HTX（原火币）的 API Key 在网页端「API 管理」创建，现货、合约共用同一组 Key；官方 API 文档写明每个主账户最多 20 组 Key，权限分读取、交易、提币三种，每组最多绑 20 个 IP，没绑 IP 的 Key 90 天后失效。2026 年有两个变动要先知道：3 月 30 日起，新注册、未完成 KYC 二级的账户不能用 API 下合约单；USDT 本位合约的旧版 API 已在 7 月 13 日停用，要改接 V5 接口（依 HTX 官方 API 文档与公告整理，查询日 2026-10-17）。
这篇整理 HTX API 的创建步骤、权限怎么勾、子账户的 Key、签名与域名、现货与合约的限速、撤单率限制，最后看 HTX 邀请规则里 API 下单怎么计佣。用邀请码 FEEOTTER 注册 HTX 并通过 Fee Otter 绑定，合约返佣 50%（30% 交易所自动返佣＋20% 额外返佣），是常见 20% 码的 2.5 倍，程序每一笔成交付的手续费，都有一半可以退回。
快速结论
- 创建位置：网页端头像菜单 → API 管理；要完成短信、邮箱与 Google 验证，Secret Key 只在创建当下显示一次。
- 三种权限：读取、交易、提币。交易权限包含下单、撤单与划转；跑策略的 Key 不要开提币权限。
- IP 与效期：每组最多 20 个 IP（主机或网段）；没绑 IP 的 Key 90 天后失效。
- KYC 门槛：2026 年 3 月 30 日起，未完成 KYC 二级的新用户不能用 API 开合约仓，子账户跟着主账户的等级走。
- 合约要接 V5：USDT 本位合约旧版 API 已在 2026 年 7 月 13 日 15:59（UTC）停用。
- 没有测试网：HTX 现货测试网已关闭，官方建议直接在正式环境用小额测试。
- 返佣：邀请规则按现货与合约的净手续费计佣，没有排除 API 下单；做市商账号不能参加。
创建步骤
依 HTX 说明中心〈如何申请 API 交易、创建 API Key〉（查询日 2026-10-17）：
- 登录 HTX 网页端，点右上角头像，选「API 管理」。
- 填写备注（必填），需要的话填上要绑定的 IP，多个 IP 用半角逗号分开。
- 勾选权限后按「创建」，完成短信、邮箱与 Google 验证码。
- 页面会跳出 Access Key 与 Secret Key。Secret Key 只显示这一次，弄丢了只能删掉重建。
- 之后可以在 API 管理页编辑备注、绑定 IP 或删除 Key。
这篇说明是 2019 年发布的，里面写「每个用户最多 5 组 Key、每组建议绑 4 个 IP」。HTX 现行的官方 API 文档〈接入准备〉写的是每个主账户最多 20 组 Key、每组最多绑 20 个 IP，两边不一致时以 API 文档和管理页实际能建的数量为准。
权限：每一种该不该开
依官方 API 文档，HTX 的 API Key 现货、合约、期权共用，权限只有三种：
| 权限 | 能做什么 | 跑策略要不要开 |
|---|---|---|
| 读取 | 查询订单、成交、资产等 | 一定要开 |
| 交易 | 下单、撤单、划转 | 要下单才开 |
| 提币 | 创建与取消提币单 | 不要开 |
要注意交易权限包含划转，拿到交易权限的程序可以在你的账户之间搬资金。只做监控、记账的工具给读取就够了。
子账户的 Key
依官方 API 文档〈子用户〉：每个主账户最多建 200 个子账户，每个子账户最多 5 组 Key，子账户的 Key 只有读取和交易两种权限，不能提币；子账户之间不能直接转账，只有主账户有划转权限。子账户的 Key 一样可以绑 IP，到期规则和主账户相同。一支策略配一个子账户，Key 泄露时损失范围比较小；子账户的交易量怎么计入返佣，见 子账户返佣规则。
HTX 的 API 文档特别提醒：Access Key 和 Secret Key 不要同时交给任何人，包括自称 HTX 的产品或人员；发现泄露就立刻删除。绑定 Fee Otter 返佣只需要 UID，不需要任何 API Key。
KYC 等级：2026 年 3 月 30 日起的 API 限制
HTX〈新用户合约杠杆限制及 API 权限调整公告〉（2026-03-30 07:00 UTC 生效，查询日 2026-10-17）对新注册用户的规定：
- 未完成 KYC，或只完成 KYC 一级：不能用 API 下合约单，要完成二级以上才开放。
- 未完成 KYC 二级：合约杠杆最高 5 倍。
- 子账户：沿用主账户的 KYC 等级，限制相同。
- 已有仓位：不受影响，撤单照常；双向持仓可以下平仓单，单向持仓可以下只减仓单，开新仓、加仓、反手与调杠杆会被要求先完成验证。
- 交易机器人：不受这次调整影响；合约跟单则一样适用。
KYC 各等级要准备什么，见 HTX KYC 验证教程。
域名与签名
依官方 API 文档：
| 产品 | REST 域名 | 备注 |
|---|---|---|
| 现货、杠杆 | https://api.huobi.pro、https://api-aws.huobi.pro | 主机在 AWS 用 api-aws，延迟较低 |
| USDT 本位合约 | https://api.hbdm.com、https://api.hbdm.vn | hbdm.vn 走 AWS CDN，hbdm.com 走 Cloudflare |
官方建议主机放在 AWS 东京，并写明不建议用代理、要用中国大陆以外的 IP 调用。
- 签名方式：HmacSHA256 或 Ed25519，签名版本 2。签名字符串是「请求方法、小写域名、路径、按 ASCII 排序并 URL 编码的参数」四段，用换行连接，算出结果后做 Base64。
- 时间戳：UTC 时间，格式
YYYY-MM-DDThh:mm:ss，5 分钟内有效。主机时间要保持同步。 - GET 与 POST 的差别：GET 要把所有参数一起签；POST 只签 AccessKeyId、SignatureMethod、SignatureVersion、Timestamp 四个，其他参数放在 body。
- 新版签名：跟单 API 已改用放在请求头的
API-KEY、API-SIGN、API-TIMESTAMP，官方说之后的功能会逐步改成新版。
下面是查询现货账户列表的最小范例（HmacSHA256），用读取权限的 Key 就够，Key 从环境变量读：
import base64, hashlib, hmac, os, urllib.parse
from datetime import datetime, timezone
import requests
ACCESS = os.environ["HTX_ACCESS_KEY"] # read-only key is enough
SECRET = os.environ["HTX_SECRET_KEY"]
HOST, PATH = "api.huobi.pro", "/v1/account/accounts"
params = {
"AccessKeyId": ACCESS,
"SignatureMethod": "HmacSHA256",
"SignatureVersion": "2",
"Timestamp": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S"),
}
query = urllib.parse.urlencode(sorted(params.items()), quote_via=urllib.parse.quote)
payload = "\n".join(["GET", HOST, PATH, query])
sig = base64.b64encode(hmac.new(SECRET.encode(), payload.encode(), hashlib.sha256).digest()).decode()
r = requests.get(f"https://{HOST}{PATH}?{query}&Signature={urllib.parse.quote(sig, safe='')}")
print(r.status_code, r.json())我们在 2026-10-17 用一组假的 Key 跑过这段程序，HTX 回的是 api-signature-not-valid（Access Key 错误），代表请求格式正确；换上你自己的 Key 就会返回账户列表。
USDT 本位合约：旧版 API 已停用，改接 V5
HTX〈USDT 本位合约交易系统 API 升级公告〉（2026-05-26）写明迁移期是 2026 年 5 月 26 日 08:00 到 7 月 13 日 15:59（UTC），截止后旧版 API 永久停用，没迁移的账户不能下单、撤单。除了行情接口，账户、订单、仓位、策略单（含跟单）都要重新对接。
- 官方建议开一个子账户做测试，调用
/v5/account/asset_mode把它切到新的单币种保证金（asset_mode=2）或多币种保证金（asset_mode=1）模式。 - 切换后，这个账户的私有接口只能走 V5，例如下单
POST /v5/trade/order、查余额GET /v5/account/balance。 - 升级后部分交易逻辑与计算公式也改了，例如新增挂单潜在亏损与风控撤单（只适用全仓），强平改成只看标记价格算出的维持保证金率。策略参数要重新校准，规则细节见 HTX 合约教程。
现货方面，官方文档写明测试网因为使用人数少、成本高已经关闭，建议直接在正式环境测试。没有测试网，第一次上线就用小额、低杠杆跑。
限速与撤单率限制
依官方 API 文档（查询日 2026-10-17）：
| 类别 | 规则 | 额度 |
|---|---|---|
| 现货下单 | /v1/order/orders/place，同一 UID 下所有 Key 合计 | 100 次／2 秒 |
| 合约私有接口 | 每个 UID | 144 次／3 秒（交易类、读取类各 72 次） |
| 合约公开接口（非行情） | 每个 IP | 240 次／3 秒 |
| 合约行情 REST | 每个 IP | 800 次／秒 |
| 合约私有 WebSocket | 每个 UID 同时连接 | 30 条 |
现货响应头带 X-HB-RateLimit-Requests-Remain，合约带 ratelimit-remaining，程序可以据此放慢。主账户和子账户分开计算。
撤单率限制：USDT 本位合约在 10 分钟内用 API 下了 3,000 笔以上的限价、Post only、FOK、IOC 单时，系统会计算撤单率；撤单率超过 99%，这四种单会被禁 5 分钟，一小时内被禁 3 次就禁 30 分钟。「无效撤单」指 0 成交、下单后 3 秒内就撤掉的单。禁止期间撤单和其他单型不受影响。高频挂撤的策略，下单前先算好这个比例。
API 下单的手续费与返佣
费率：HTX 一般用户（Prime 0）现货 maker、taker 都是 0.2%，U 本位合约 maker 0.02%、taker 0.06%；30 日合约量到 500 万 USDT 是 Prime 2，taker 0.05%（等级表见 HTX VIP 等级与手续费）。官方没有另外列 API 费率，以账户「我的费率」为准。
返佣：依〈HTX 邀请交易奖励规则〉（查询日 2026-10-17），被邀请人做现货或合约交易时，邀请人按被邀请人实际支付的净手续费计佣。规则没有把 API 下单排除，但下面几种不计或另外分配：
- 用现货回馈券、合约体验金、0 费率、负费率成交的手续费不计。
- 做市商不能参加邀请计划；API 文档的做市商方案也写明，做市商不能使用点卡、VIP 费率或返佣。
- Prime 9 以上的用户不再为邀请人贡献佣金。
- 通过经纪商（Broker）下单时，佣金至少 70% 给邀请人、最多 30% 给经纪商。
所以一般账号自己写程序或用 API 下单，只要付了手续费，就照现货、合约的规则计佣；实际有没有计入，看返佣明细。这和 MEXC 不同，MEXC 的联盟规则写明 API 交易一律不计佣。
换成程序常见的量级：月合约量 500 万 USDT、全部吃单，刚好到 Prime 2，taker 0.05%，手续费 2,500 USDT。通过 Fee Otter 绑定退回 50%，也就是 1,250 USDT，其中 750 USDT 由 HTX 直接退回账户、500 USDT 由 Fee Otter 每天结算；常见 20% 码只退 500 USDT。
这是我们用官方费率算的示范，实际以成交纪录与返佣明细为准。返佣只算交易手续费，资金费不在范围内。HTX 的返佣截图可在 返佣比例页 查看，注册步骤见 HTX 注册教程；HTX 推荐码绑定后不能更改，已经用别人的码注册的见 HTX 换绑教程，多家交易所的试算见 程序化交易手续费返佣。
如果你本来就是交易所 VIP、或月交易量大的程序化交易者，想换绑或注册其他交易所，可以联系 Fee Otter 客服：我们会直接对接交易所官方窗口，帮忙申请特别的交易福利或更高的返佣比例，实际福利以交易所核定为准。
Telegram · @feeotter
