KuCoin API 交易设置 2026：API 单没有返佣、权限与 Passphrase、经典与统一账户限速

先讲最重要的一件事：KuCoin 通过 API 下的单没有返佣。KuCoin 邀请好友页的规则写「API trading is currently not eligible for commission」，所以程序与机器人的 API 单拿不到 KuCoin 的 60% 自动返佣。API 本身照常能用：创建 Key 时要记下 Key、Secret、Passphrase 三项，遗失只能重建；经典账户 VIP0 现货额度每 30 秒 4,000、合约每 30 秒 2,000；开提币权限必须绑 IP（依 KuCoin 官方 API 文档，查询日 2026-10-17）。

这篇依 KuCoin 官方 API 文档（kucoin.com/docs-new）、邀请好友页、联盟计划公告与公开 API 的实时数据整理：Key 怎么开、权限怎么勾、经典账户与统一账户的限速差在哪、一段可以直接跑的查费率程序，最后用数字说明 API 单没有返佣，手续费成本差多少。

快速结论

• API 单没有返佣：KuCoin 邀请好友页写明 API 交易目前不计佣金；跑程序的人计算成本时，返佣要算 0。
• KuCoin 自己的交易机器人有算：同一页写佣金涵盖「现货（含现货、杠杆与交易机器人）、ETF 与合约」，指的是 KuCoin 平台内置的机器人，不是自己写的 API 程序。
• 三项凭证：Key、Secret 由 KuCoin 产生，Passphrase 是你自己设的；三项都找不回来，掉了就重建。
• 两种账户、两套限速：经典账户按 30 秒计额度，主账户与子账户各自独立；统一账户（UTA）VIP0 每秒 300，主子账户共用总额度。
• 手续费：查询当天，BTC 永续（XBTUSDTM）挂单 0.02%、吃单 0.06%，BTC-USDT 现货属 A 类 0.1%。

API 单没有返佣：官方原文与影响

KuCoin〈邀请好友〉页的规则写：「API trading is currently not eligible for commission.」返佣来自交易所付给推荐人的佣金，API 单不产生佣金，你这边就没有可退的部分。KuCoin 2025 年 9 月的〈联盟计划公告〉没有另外写 API 的条款，但写了零手续费成交不计佣金、推荐人佣金变 0 时被邀请人的返现也变 0。

同一份联盟公告还有一条要注意：被邀请人到达某个 VIP 等级后不再计佣金，一处写 Level 3 以上、另一处写 LV4 以上。跑量大的程序很容易升级，详细见 KuCoin VIP 等级。

用数字看差多少。假设一个程序每月在 BTC 永续做 200 万 USDT 的吃单成交，以查询当天的吃单费率 0.06% 计：

这是我们用官方费率算的示范。在 KuCoin 跑自己的 API 策略，手续费就是全额；KuCoin 合约吃单 0.06% 在主要交易所里偏高，策略以吃单为主的话，这笔成本要先算进去。各家 API 的成本比较见 交易所 API 比较 与 程序交易手续费返佣。

KuCoin 的 API 文档另有 Broker Program，分 API 经纪商与交易所经纪商，对象是替别人下单的平台。这是平台和 KuCoin 之间的合作，和一般邀请码的返佣是两回事。

创建 API Key：三项凭证与账户类型

1. 登录后到 API 管理页 创建 Key，自己设置一组 Passphrase。
2. 记下 Key、Secret、Passphrase。官方文档写明这三项遗失后无法找回，只能创建新的 Key。
3. 每个私有请求要带 KC-API-KEY、KC-API-SIGN、KC-API-TIMESTAMP（毫秒）、KC-API-PASSPHRASE、KC-API-KEY-VERSION 五个请求头；版本号可以在 API 管理页看到，官方示例用 3。
4. 先确定账户是经典账户还是统一账户（UTA）。经典账户的现货走 https://api.kucoin.com、合约走 https://api-futures.kucoin.com；统一账户都走 https://api.kucoin.com，官方建议新程序升级到统一账户后用 UTA API V2。

来源：KuCoin Authentication、KuCoin API Introduction，查询日 2026-10-17。

官方文档写了子账户 Key 的规则：每把最多绑 20 个 IP，期限可选 30、90、180、360 天或不过期（Add Sub Account API）。主账户 Key 没绑 IP 会不会到期，这次查到的官方文档没有写，以 API 管理页显示为准。

权限怎么勾

来源：KuCoin API Introduction 的 api-permission 一节，查询日 2026-10-17。官方也写，授权 Transfer 权限后，用 API 划转不需要邮件或 Google 验证。提币权限跑策略用不到，一律不勾；就算 Key 外泄，对方也不能用这把 Key 把资产提走。

限速：经典账户与统一账户分开算

经典账户

• 计算单位：要带 Key 的端点按 UID 计，公开端点按 IP 计。主账户与子账户的额度各自独立，需要更多额度可以把策略分到子账户。
• 超限：返回 HTTP 429、错误码 429000，要停止送请求等额度重置。每个响应都带 gw-ratelimit-limit、gw-ratelimit-remaining、gw-ratelimit-reset（毫秒）三个请求头，程序读这三个值自己放慢。
• 文档写法不一致：额度表以 30 秒为单位，同一页的权重说明却写每 1 秒更新、举例 VIP5 每秒 700。实际以响应请求头为准。
• WebSocket：最多 800 条同时连接；每条连接每 10 秒最多 100 则消息；每次订阅最多 100 个主题；现货单一连接最多 400 个主题。

统一账户（UTA）

• 额度：交易池（含 WebSocket 下单）VIP0 每秒 300、VIP5 每秒 900、VIP12 每秒 4,000；公开端点每 30 秒 2,000。
• 主子账户共用：总额度按 VIP 等级给，由你自己分配给子账户；新子账户默认每秒 10 次，不占总额度。
• V1 与 V2 共用：V1、V2 API 扣同一个额度池，升级 V2 不会多出额度。

来源：Rate Limit Rule (Classic)、Rate Limit Rule (UTA)，查询日 2026-10-17。专业交易者或做市商需要更高额度，官方写可以寄信到 api@kucoin.com，附上账号、原因与预估交易量。

测试：先用只读 Key 跑通签名

这次查到的 KuCoin API 文档目录没有列出测试网或模拟交易环境。比较稳的做法，是先建一把只有 General 权限的 Key，把签名跑通，再换成有交易权限的 Key，用最小下单量、低杠杆试。

下面查 BTC-USDT 实际费率的示例照官方签名规则：把「时间戳＋方法＋路径＋内容」用 Secret 做 HMAC-SHA256 再 base64；Passphrase 也要用 Secret 做 HMAC-SHA256 再 base64。Key 从环境变量读，不要写死在程序里：

import base64, hashlib, hmac, os, time, requests

KEY = os.environ["KUCOIN_API_KEY"]          # General (read-only) is enough
SECRET = os.environ["KUCOIN_API_SECRET"]
PASSPHRASE = os.environ["KUCOIN_API_PASSPHRASE"]

def b64_hmac(msg):
    return base64.b64encode(hmac.new(SECRET.encode(), msg.encode(), hashlib.sha256).digest()).decode()

path = "/api/v1/trade-fees?symbols=BTC-USDT"
ts = str(int(time.time() * 1000))
headers = {
    "KC-API-KEY": KEY,
    "KC-API-SIGN": b64_hmac(ts + "GET" + path),
    "KC-API-TIMESTAMP": ts,
    "KC-API-PASSPHRASE": b64_hmac(PASSPHRASE),
    "KC-API-KEY-VERSION": "3",
    "Content-Type": "application/json",
}
r = requests.get("https://api.kucoin.com" + path, headers=headers)
print(r.status_code, r.json())

返回的是你这个账号在 BTC-USDT 的 maker、taker 费率。签名错误时先检查方法是不是大写、路径有没有包含查询字符串，这是官方文档特别列出的注意事项。

手续费：API 单照一般费率

KuCoin 没有另外公布 API 专用费率。以查询当天公开 API 的数据为例：

来源：KuCoin 合约公开 API、KuCoin 现货交易对清单（feeCategory 字段），查询日 2026-10-17；B、C 类费率取自 KuCoin 说明中心的 VIP 费率结构。程序扫全市场时，C 类冷门币的手续费是 A 类的 3 倍，选标的前先看 feeCategory。VIP 等级怎么算见 KuCoin VIP 等级。

服务地区

KuCoin 使用条款（2026-09-29 更新）列出的限制地区包括美国及其属地、新加坡、中国大陆与香港、马来西亚、哈萨克斯坦、乌兹别克斯坦、加拿大安大略省与不列颠哥伦比亚省、法国、荷兰，以及乌克兰的克里米亚、顿涅茨克、卢甘斯克、扎波罗热、赫尔松地区，清单可能随时更新。邀请好友页另写比利时、法国、荷兰等地居民不能参加推荐计划。策略放在云端服务器时，服务器所在地与你本人的居住地都要注意。各国牌照见 交易所牌照比较。

安全与风险

• 一个用途一把 Key：自己的策略、第三方机器人、记账工具分开，哪一把出事就只删那一把。
• 绑 IP：策略放在固定 IP 的服务器就绑上；要开提币或 FlexTransfers 权限，官方规定必须绑。
• Passphrase 和密码分开：Passphrase 是 API 专用，不要和登录密码相同。
• 程序风险：程序错误、断线或行情跳动都可能造成亏损，合约还有强平风险；先用小额与低杠杆跑。

不要把 API Key 交给任何声称能帮你代操、稳赚不赔的人，有提币权限的 Key 更不行。KuCoin 的储备状况见 KuCoin 储备证明。

想用程序交易又要返佣，怎么选

在 KuCoin，返佣只对非 API 的交易有效。用我们的邀请码 FEEOTTER 注册，手动交易的手续费返佣是 60%（全部由 KuCoin 自动退回），现货与合约相同，不需要到 Fee Otter 申请提取。返佣只算交易手续费，不含资金费与强平；API 下的单在 KuCoin 没有返佣。

想自动化又想保留返佣，可以先看 KuCoin 平台内置的交易机器人，邀请好友页把它算在佣金范围内，见 KuCoin 交易机器人教学。主要靠自己写 API 的人，可以看其他交易所的规则：Bybit API 交易设置、币安 API 交易设置、OKX API 交易设置；MEXC 也一样不给 API 单返佣，见 MEXC API 交易设置。

常见问题

KuCoin 用 API 下单有返佣吗？

没有。KuCoin 邀请好友页写明 API 交易目前不计佣金，所以 60% 自动返佣不适用 API 单。

KuCoin 内置的网格机器人有返佣吗？

邀请好友页写佣金涵盖现货（含交易机器人）与合约，所以平台内置机器人产生的手续费列在范围内，实际以返佣明细为准。

Passphrase 忘了怎么办？

找不回来。官方文档写 Key、Secret、Passphrase 遗失后都要删掉重建。

返回 429000 怎么办？

代表超过限速。停止送请求，看 gw-ratelimit-reset 请求头的毫秒数，等额度重置再送。

KuCoin 有测试网吗？

这次查到的官方 API 文档目录没有列出测试网。可以先用只读 Key 验证签名，再用最小下单量试。

绑定返佣需要提供 API Key 吗？

不需要。KuCoin 的 60% 在注册时用邀请码就由交易所自动退回，Fee Otter 不会向你索取 API Key。

延伸阅读

• 交易所 API 比较
• KuCoin 合约教学
• KuCoin 手续费返佣攻略
• KuCoin 理财教学

本文权限、限速与签名规则取自 KuCoin 官方 API 文档，API 交易不计佣金的规则取自 KuCoin 邀请好友页，联盟条款取自 KuCoin 2025-09-11 公告，费率取自 KuCoin 公开 API，查询日 2026-10-17。KuCoin 会调整限速、费率与条款，一切以官方实时内容为准。代码仅为示范，实盘前请自行测试。返佣比例由交易所设置、可能调整。本文为信息参考，非投资建议。

数据核实日：2026-10-17