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