Gate API 交易設定 2026：API Key 五組權限、IP 白名單與 90 天效期、限速與返佣

Gate 的 API Key 在網頁版「API 管理」建立，建立前要先完成身分驗證、設好資金密碼與雙重驗證；權限分現貨／槓桿、永續合約、交割合約、錢包、提現五組，每組可選關閉、唯讀或讀寫，跑策略用不到的提現權限不要開。每把 Key 最多綁 20 個 IPv4，沒綁 IP 的 Key 只有 90 天效期；永續合約下單與改單合計 100 次／秒、現貨 10 次／秒（2026 年 10 月 17 日核實）。

本文依 Gate 說明中心的 API 建立教學與官方 API v4 文件整理：Key 怎麼建、權限怎麼勾、IP 白名單和效期、簽名與時間戳、各類端點的限速、測試網，最後說明 API 下單的手續費與返佣在官方條款裡怎麼寫。用邀請碼 FEEOTTER 註冊 Gate，合約返佣 70%（20% 交易所自動返佣＋50% 額外返佣），是市面常見 20% 邀請碼的 3.5 倍，策略每一筆成交付出的手續費，都有一部分可以退回。

快速結論

• 網頁版建立：頭像選單 → API 管理 → 建立 API Key；需要已完成身分驗證、資金密碼與雙重驗證，送出前要輸入資金密碼與 2FA。
• 權限五組：現貨／槓桿、永續合約、交割合約、錢包、提現，各自關閉／唯讀／讀寫。跑合約策略開永續合約讀寫就夠，提現權限一律不要開。
• IP 白名單：每把 Key 最多 20 個 IPv4，不支援 IP 區段；不綁 IP 的 Key 任何位址都能用，效期 90 天。
• 限速：永續合約下單＋改單 100 次／秒、撤單 200 次／秒；現貨下單＋改單 10 次／秒；按主帳戶或子帳戶分開計算。
• 測試網：主網 Key 不能拿去測試網用，要在「Futures TestNet APIKeys」分頁另外建立。
• 返佣：Gate 推薦規則沒有提到 API，是否計入以返佣明細為準。綁定返佣只需要 UID，不用交出任何 API Key。

建立步驟

依 Gate〈如何在 Gate 網頁版建立與管理 API Key〉（查詢日 2026-10-17）：

1. 先完成帳戶身分驗證、設定資金密碼與雙重驗證（2FA）。
2. 網頁版滑到右上角頭像，選「API 管理」，點「建立 API Key」。
3. 選 APIv4 Key：填備註、設定 IP 綁定、選帳戶類型、勾權限與交易對。
4. 閱讀風險提示並同意，輸入資金密碼、選 2FA 方式確認。
5. 之後可以在 API 管理頁查看、編輯或刪除 Key。

同一篇教學還保留舊版 APIv2 Key：只能做現貨，每個用戶只能有一組，建立新的會讓舊的立刻失效。APIv4 支援現貨、槓桿與合約，可以同時有多把。新策略直接用 APIv4。這篇教學的發布日期是 2020 年，頁面上的選項名稱可能和你看到的不同，以實際畫面為準。

Key 能建幾把，官方 API 文件前後寫法不一致：一處寫「每個帳戶可以建立 20 把 API Key，每把的權限設定互相獨立」，另一處寫「每個用戶最多建立 5 把權限各自獨立的 Key」（Gate API v4 文件，查詢日 2026-10-17）。以 API 管理頁實際能建的數量為準。文件也寫明，改了 Key 的設定，最多要 5 分鐘才生效，改完別急著判定設定失敗。

權限：每一組該不該開

依官方 API v4 文件的權限說明：

只做監控、記帳的工具，全部給唯讀就夠了。子帳戶的 Key 有兩個限制：不能做主子帳戶之間的劃轉（POST /wallet/sub_account_transfers），也不能提現（POST /withdrawals）；子帳戶沒有對應業務權限時，相關操作也會被拒。一支策略配一個子帳戶，額度和風險就能分開管。

Gate 的教學寫明，API 提現有兩道門檻：提現地址必須是你曾經手動提現過的地址，而且距離上一次手動提現至少要過 24 小時。就算如此，跑策略的 Key 還是不要開提現權限，Key 外洩時對方就無法用它把資產提走。

IP 白名單與 Key 效期

• 最多 20 個 IP：官方文件寫明每把 Key 最多綁 20 個 IPv4 位址，不支援 IP 區段。
• 不綁就不檢查：沒設白名單時，伺服器不驗證來源 IP。
• 不綁 IP 的效期是 90 天：說明中心寫明，不綁 IP 的 Key 允許任何位址存取，效期 90 天。綁了 IP 的 Key 有沒有效期，官方頁面沒有寫。

策略放在固定 IP 的雲端主機，就把主機的出口 IP 綁上；用浮動 IP 的家用網路跑，記得在 90 天內重建 Key。策略哪天突然全部驗證失敗，先查 Key 是不是到期。

簽名、時間戳與網域

依官方 API v4 文件：

• 網域：主網 https://api.gateio.ws/api/v4；只做合約的另有 https://fx-api.gateio.ws/api/v4；測試網 https://api-testnet.gateapi.io/api/v4。
• 標頭：私有端點帶 KEY、Timestamp、SIGN 三個標頭。
• 簽名：HexEncode(HMAC_SHA512(secret, 簽名字串))。簽名字串是「請求方法、請求路徑、查詢字串、請求內容的 SHA512 十六進位、時間戳」五段，用換行連接；沒有請求內容時，用空字串的 SHA512。
• 時間戳：Unix 秒，與伺服器時間相差不能超過 60 秒。主機時間要保持 NTP 同步。

下面是用測試網 Key 查詢 USDT 永續合約帳戶的最小範例，Key 從環境變數讀，不要寫死在程式裡：

import hashlib, hmac, os, time, requests

KEY = os.environ["GATE_TESTNET_KEY"]        # testnet key, read-only is enough
SECRET = os.environ["GATE_TESTNET_SECRET"]
HOST = "https://api-testnet.gateapi.io"
PREFIX = "/api/v4"
path, query = "/futures/usdt/accounts", ""

ts = str(int(time.time()))
body_hash = hashlib.sha512(b"").hexdigest()
payload = "\n".join(["GET", PREFIX + path, query, body_hash, ts])
sign = hmac.new(SECRET.encode(), payload.encode(), hashlib.sha512).hexdigest()

r = requests.get(HOST + PREFIX + path, headers={
    "KEY": KEY, "Timestamp": ts, "SIGN": sign, "Accept": "application/json",
})
print(r.status_code, r.headers.get("X-Gate-RateLimit-Requests-Remain"))

跑通之後，把網域換成 api.gateio.ws、Key 換成主網的，同一段程式就能用。

限速：各類端點的額度

Gate 的限速按主帳戶或子帳戶分開計算（官方 API v4 文件，查詢日 2026-10-17）：

每次回應會帶 X-Gate-RateLimit-Requests-Remain（剩餘次數）、X-Gate-RateLimit-Limit（額度）、X-Gate-RateLimit-Reset-Timestamp（重置時間），程式可以據此自動放慢。

成交比率規則：官方文件另有一條只適用 VIP 14 以上的現貨規則：短時間內頻繁下單、撤單、改單但成交比率低的 UID，下單與改單會被限到每 10 秒 10 次。成交比率＝USDT 成交額 ÷（下單＋撤單＋改單請求總數），每小時按過去 24 小時計算，官方建議維持在 0.1 以上。合約版的成交比率分級（100～400 次／秒）文件寫明「目前未生效」。

先在測試網跑

官方文件寫明合約測試網是獨立環境，主網的 API Key 不能用在測試網；測試網 Key 要在 API 管理頁的「Futures TestNet APIKeys」分頁建立，除了網域和 Key，請求格式都一樣。網頁版的合約測試網每天可以領 0.1 BTC 或 1,000 USDT 模擬資金，不收真實手續費（見 Gate 合約教學）。

API 下單的手續費與返佣

費率：Gate 的 USDT 永續 VIP 0 費率是 maker 0.02%、taker 0.05%（官方費率公告）。官方費率頁沒有另外列 API 費率，實際費率以 官方費率頁 登入後顯示的為準，返佣後的實付費率見 Gate 手續費返佣攻略。

返佣：Gate〈推薦計畫規則〉寫的是被推薦人做現貨、Alpha、合約或槓桿交易時，按產生的交易手續費一定比例計佣；〈聯盟計畫頁〉列的是現貨、合約、Alpha、Web3、CFD 與期權。兩頁都沒有提到 API，沒有把 API 下單排除，也沒有說明 API 下單一定計入，所以 API 產生的手續費是否計入，以返佣明細為準。另外兩個相關但不同的計畫：

• 經紀商計畫是給串接 API、帶用戶下單的經紀商，跟一般推薦是不同的計畫。
• 做市商計畫提供 maker 手續費返還、更高的 API 限速與 COLO 機房，資格要問 VIP 客戶經理。做市商優惠能不能和推薦佣金同時拿，官方頁面沒有寫，申請前先確認。

不要把 API Key 交給任何聲稱可以幫你代操、保證獲利的人，有提現權限的 Key 更是絕對不行。詐騙集團常用「穩賺不賠」「高獲利低風險」話術誘導投入虛擬資產，事後再以解凍金、保證金或稅款名義要求繳款。

Fee Otter 的 Gate 返佣是合約 70%（20% 交易所自動返佣＋50% 額外返佣），邀請碼 FEEOTTER。換成程式常見的量級：月合約量 500 萬 USDT、全部吃單，手續費 2,500 USDT，每月退回約 1,750 USDT；常見 20% 碼只退 500 USDT。其中 20% 由 Gate 直接退回交易所帳戶，50% 由 Fee Otter 每天結算，可在 返佣比例頁看截圖。註冊步驟見 Gate 註冊教學，已經用別人的碼註冊的見 Gate 換綁教學，多家交易所的試算見 程式交易手續費返佣。

如果你本來就是交易所 VIP、或月交易量大的高頻交易者，想換綁或註冊其他交易所，可以聯繫 Fee Otter 客服：我們會直接對接交易所官方窗口，幫忙申請特別的交易福利或更高的返佣比例，實際福利以交易所核定為準。

安全：一個用途一把 Key

• 分開建 Key：自己的策略、第三方機器人、記帳工具各用一把，權限只給需要的；哪一把出問題就只刪那一把。
• 第三方平台只給交易權限：不開提現，對方有公布固定出口 IP 就綁上；停用服務後立刻到 API 管理頁刪除。
• Key 與 Secret 不進版本控制：放在環境變數或密鑰管理服務，不要貼進程式碼、截圖或群組。
• 定期檢查：到 API 管理頁看有沒有不認得的 Key，以及每把 Key 的權限與綁定 IP。

地區限制

Gate〈限制地區〉（查詢日 2026-10-17）列出的不提供服務地區包括美國、中國大陸、新加坡、加拿大、法國、德國、香港、馬來西亞、英國、荷蘭、西班牙、奧地利、日本、韓國、印尼、泰國、印度、阿聯、阿根廷等，並寫明「包括但不限於」、可能不經通知變更。住在這些地區的用戶不能使用 Gate。各國牌照狀況見 交易所牌照比較。

常見問題

Gate API Key 在哪裡建立？

網頁版右上角頭像 → API 管理 → 建立 API Key。要先完成身分驗證、設定資金密碼與雙重驗證。

沒綁 IP 的 Gate API Key 多久失效？

Gate 說明中心寫明效期 90 天。綁了 IP 的 Key 有沒有效期，官方頁面沒有寫。

一把 Key 可以綁幾個 IP？

最多 20 個 IPv4 位址，不支援 IP 區段。

Gate API 下單限速是多少？

永續合約下單＋改單 100 次／秒、撤單 200 次／秒；現貨下單＋改單 10 次／秒、撤單 200 次／秒，按主帳戶或子帳戶分開計算。

用 API 下單還能拿返佣嗎？

Gate 推薦規則按現貨、Alpha、合約、槓桿的交易手續費計佣，沒有提到 API，是否計入以返佣明細為準。參加做市商計畫的帳號，先向 Gate 確認能否和推薦佣金同時拿。

綁定 Fee Otter 返佣需要提供 API Key 嗎？

不需要。綁定只要 UID，不需要 API Key、密碼或提現權限。

延伸閱讀

• Gate 手續費返佣攻略
• Gate 合約教學
• 交易所 API 比較
• 程式交易手續費返佣
• Bybit API 交易設定

本文權限、限速與測試網規則取自 Gate 官方 API v4 文件與說明中心，查詢日 2026-10-17；Gate 的建立教學發布於 2020 年，畫面可能已更新，Gate 也會調整限速與規則，一切以官方文件即時內容為準。程式碼僅為示範，實盤前請自行測試。返佣比例由交易所與平台設定、可能調整。本文為資訊參考，非投資建議。

數據核實日：2026-10-17

ⓘ 文中 Fee Otter 返佣比例為合約；現貨：Gate 65%（20% 自動＋45% 額外）。