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% 额外）。