XT.COM 的 API 不是開了就能用：要先在網頁版「API 管理」按「Create API」送出 API 交易申請，官方寫明審核 3～5 個工作天，帳戶餘額超過 50,000 USDT 可以加快；通過後才能建立 Key。每個帳號最多 10 組 Key，IP 白名單選填，可填單一 IP 或 IP 區段；新 Key 預設只有查詢權限，交易與提幣要另外開。現貨下單 20 次／秒、合約下單 200 次／秒（每把 Key），而且不是每個交易對都開放 API（2026 年 10 月 17 日查詢）。
本文依 XT.COM 說明中心的 API 申請教學與官方 API 文件（doc.xt.com）整理：申請與建立步驟、權限與 IP 白名單、現貨與合約兩套不同的簽名方式、限速、哪些交易對能用 API，最後說明 API 下單的手續費與返佣在官方頁面怎麼寫。用邀請碼 FEEOTTER 註冊 XT.COM，合約返佣 70%（60% 交易所自動返佣＋10% 額外返佣），是市面常見 20% 碼的 3.5 倍；API 下單是否計入，官方沒有寫，後面會說明怎麼確認。
快速結論
- 先申請再建 Key：API 管理 → Create API → Submit for Review，審核 3～5 個工作天；官方建議帳戶餘額超過 50,000 USDT 以加快審核。
- 數量：主帳號最多 10 組 Key；每個子帳號也能各自建立最多 10 組。
- 權限：預設只有查詢，交易與提幣要另外授權；跑策略用不到的提幣權限不要開。
- Secret 只顯示一次：忘了無法找回，只能刪掉重建。
- 兩套網域與簽名：現貨
sapi.xt.com，USDT 本位合約fapi.xt.com、幣本位dapi.xt.com；現貨和合約的簽名字串組法不同。 - 返佣：XT.COM 推薦規則沒有提到 API，是否計入以返佣明細為準。綁定返佣只需要 UID，不用交出任何 API Key。
第一步：申請 API 交易
依官方〈如何申請 API 交易並建立 API Key〉（查詢日 2026-10-17）：
- 登入 www.xt.com，在用戶中心點「API Management」。
- 點「Create API」，再按「Submit for Review」送出 API 交易申請。
- 等待審核。官方寫明 API 權限要經過風控審查，一般 3～5 個工作天；帳戶餘額超過 50,000 USDT 可加快。
餘額遠低於 50,000 USDT 的帳號能不能通過、會不會被拒，官方頁面沒有寫，只寫了加快審核的條件。打算跑程式的人，最好在要上線之前一週就先送申請。
第二步：建立 API Key
- 審核通過後，回到「API Management」。
- 填「Alias Name」（必填）與「Whitelist IP」（選填）。白名單可以填單一 IP 或 IP 區段，多筆用逗號分隔，例如
192.168.1.1, 192.168.1.2。 - 輸入 Google 驗證碼，點「Create API」。
- 畫面會顯示 Public Key 與 Private Key（Secret），只顯示這一次，立刻存好，不要分享這個頁面。
- 之後可用「Modify」改備註、權限與 IP，或用「Delete」刪除。
子帳號：用戶中心 → Sub-account → API Management，選子帳號後點「Create API」，完成安全驗證即可。依〈子帳號常見問題〉，每個子帳號最多 10 組 Key，可用來下單、查詢與管理倉位；主子帳號之間劃轉免手續費。一支策略配一個子帳號，額度和風險就能分開管。
權限與 IP 白名單
- 預設只讀：官方寫明新 Key 預設只有查詢權限，交易與提幣服務要授權後才能用。只做監控或記帳的工具，維持預設即可。
- 理財另有權限：官方 Earn API 文件寫明要開啟 Earn 權限才能呼叫申購、贖回端點。
- 超出權限的錯誤：官方錯誤碼
AUTH_106是「超出 apikey 權限」；AUTH_104是「未綁定 IP 的請求」；合約端在 IP 不在白名單時回 HTTP 403（現貨錯誤碼、合約錯誤碼）。 - 效期：沒綁 IP 的 Key 會不會過期，官方頁面沒有寫。
策略放在固定 IP 的雲端主機，就把主機的出口 IP 綁上。官方也建議不要透過代理連 API，延遲高、穩定性差。
簽名：現貨和合約不一樣
現貨（sapi.xt.com）
- 標頭：
validate-algorithms（建議 HmacSHA256）、validate-appkey、validate-recvwindow、validate-timestamp（毫秒）、validate-signature。 - X：把上面前四個標頭按字母排序，用
&串起來。 - Y：
#方法#路徑#查詢字串#請求內容；查詢字串按鍵名排序，JSON 內容用原始字串、不要重排；沒有的部分省略。 - 簽名：對 X＋Y 做 HmacSHA256（金鑰是 Secret），輸出十六進位。
- 時間：伺服器時間減去 timestamp 要小於 recvwindow（預設 5 秒，官方不建議超過 5 秒）；timestamp 比伺服器時間快超過 1 秒也會被拒（錯誤碼
AUTH_105）。主機時間要保持 NTP 同步。
合約（fapi.xt.com／dapi.xt.com）
依〈合約簽名〉，待簽字串是 validate-appkey=…&validate-timestamp=…，接 # 端點路徑，再接 # 查詢字串或請求內容，用 HmacSHA256 簽；標頭帶 validate-appkey、validate-timestamp、validate-signature。合約的 recvwindow 同樣預設 5 秒、最多 60 秒。
下面是查詢現貨 USDT 餘額的最小範例（GET /v4/balances），Key 從環境變數讀，不要寫死在程式裡；先用只讀的 Key 跑通：
import hashlib, hmac, os, time, requests
KEY = os.environ["XT_API_KEY"] # read-only key is enough
SECRET = os.environ["XT_API_SECRET"]
HOST = "https://sapi.xt.com"
path, query = "/v4/balances", "currencies=usdt"
headers = {
"validate-algorithms": "HmacSHA256",
"validate-appkey": KEY,
"validate-recvwindow": "5000",
"validate-timestamp": str(int(time.time() * 1000)),
}
x = "&".join(f"{k}={headers[k]}" for k in sorted(headers))
y = f"#GET#{path}#{query}"
headers["validate-signature"] = hmac.new(
SECRET.encode(), (x + y).encode(), hashlib.sha256).hexdigest()
headers["Content-Type"] = "application/json"
r = requests.get(f"{HOST}{path}?{query}", headers=headers)
print(r.status_code, r.json().get("rc"), r.json().get("mc"))回 AUTH_103（簽名錯誤）時，先檢查查詢字串有沒有排序、X 的標頭順序，以及 Secret 有沒有多複製到空白。
限速
官方文件把限速寫在每個端點上，另有一般規則（查詢日 2026-10-17）：
| 類別 | 端點 | 額度 |
|---|---|---|
| 現貨 | 下單 POST /v4/order | 20 次／秒／apikey |
| 現貨 | 查餘額 GET /v4/balances | 10 次／秒／apikey |
| 合約 | 下單 /future/trade/v1/order/create | 200 次／秒／apikey |
| 合約（一般規則） | 資產類端點 | 3 次／秒 |
| 合約（一般規則） | 其他端點 | 每用戶 10 次／秒，每 IP 1,000 次／分 |
合約文件的一般規則寫「其他端點每用戶 10 次／秒」，但下單端點頁寫 200 次／秒，兩處不一致，以實際回應為準。超過限速會回 HTTP 429，IP 或 apikey 會被封鎖；合約文件寫明超限時帳號鎖 10 分鐘。程式要自己控制頻率，不要靠撞 429 才停。
不是每個交易對都能用 API
XT.COM 2023 年的〈開放 API 公告〉寫的是「為部分交易對開放 API」。2026-10-17 查官方公開資料：現貨交易對 API 上線且可交易的 1,032 個交易對中，標示 openapiEnabled 的是 484 個；合約交易對 API 前台顯示且可交易的 723 個合約中，標示 isOpenApi 的是 662 個。BTC_USDT、ETH_USDT 的現貨與合約都有開放。上線前先用這兩個公開端點確認你要跑的交易對。
官方 API 文件沒有提供測試網網域。XT.COM 有網頁版的合約模擬交易，但官方頁面沒有說它能用 API 串接；只能用小額實盤測試，所以下單數量、精度與最小名目先查交易對規格。
API 下單的手續費與返佣
費率：2026-10-17 查官方公開 API，BTC_USDT 現貨 maker／taker 都是 0.2%；BTC_USDT 合約 maker 0.04%、taker 0.06%。官方沒有另外列 API 專屬費率，VIP 等級怎麼降費率見 XT.COM VIP 等級。
返佣：XT.COM 的推薦與聯盟計畫說明寫的是，被邀請人產生的每一筆有效交易手續費都會計佣，涵蓋現貨、槓桿與合約；頁面沒有提到 API，沒有把 API 下單排除，也沒有說一定計入，所以 API 產生的手續費是否計入，以返佣明細為準。另一個相關但不同的計畫是 XT 經紀商計畫：給串接 API 帶用戶下單的交易平台、機器人服務商等，申請通過後拿 Broker ID 綁在 API 交易上，官方寫最高 60% 分級返佣與更高的 API 限速。經紀商返佣能不能和推薦佣金同時拿，官方頁面沒有寫。
不要把 API Key 交給任何聲稱可以幫你代操、保證獲利的人，有提幣權限的 Key 更是絕對不行。詐騙常用「穩賺不賠」「高獲利低風險」話術誘導投入，事後再以解凍金、保證金或稅款名義要求繳款。
Fee Otter 的 XT.COM 返佣是合約 70%（60% 交易所自動返佣＋10% 額外返佣），邀請碼 FEEOTTER。換成程式常見的量級：月合約量 500 萬 USDT、全部吃單，手續費 3,000 USDT；若 API 成交計入返佣，每月退回約 2,100 USDT，常見 20% 碼只退 600 USDT。其中 60% 由 XT.COM 直接退回交易所帳戶，10% 由 Fee Otter 每天結算，可在 返佣比例頁看截圖。開始跑之前，先用小量 API 下單，隔天在返佣明細確認有沒有計入。註冊步驟見 XT.COM 註冊教學，已有帳號的見 XT.COM 換綁教學，多家交易所的試算見 程式交易手續費返佣。
如果你本來就是交易所 VIP、或月交易量大的高頻交易者，想換綁或註冊其他交易所，可以聯繫 Fee Otter 客服：我們會直接對接交易所官方窗口，幫忙申請特別的交易福利或更高的返佣比例，實際福利以交易所核定為準。
Telegram · @feeotter
