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
