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
