Gate.io API Key 申请教学:唯读权限设置完整步骤(2026)
发布于 2026年7月17日
作者 ExAgg 团队 — 我们亲手打造了串接 10 家交易所与 40+ 条链的资产追踪 App,以下都是实作路上踩过、验证过的经验。
Gate.io 的资产想接进追踪 App,申请一把唯读 APIv4 Key 就能做到:App 只能读取余额与纪录,下单、提币都会被 Gate 服务器挡掉,密钥外流也动不了钱(原理见唯读 API Key 安全吗?)。
Gate 最大的特色(也是最大的雷):权限是逐项独立设置的,每一项有「唯读 / 读写 / 无权限」三种选择——每一项都要选唯读,不要留任何一项是「无权限」,否则那一块资产就读不到。
还没有 Gate 帐号?先到 Gate 官方注册页完成注册。
申请步骤(手机 App）
以下用 Gate App 示范。若用网页版,流程相同:登录后进入帐户设置里的「API Keys」(直接打开),一样把每一项权限都设成「唯读」即可。
第一步:打开「More(更多)」
登录 Gate App,在首页功能列最右边点「More(更多)」,展开全部功能。
第二步:进入「API」
在「Others(其他)」清单里点「API」。
第三步:点「Create API Key(创建 API Key)」
在 API 管理页按下蓝色的「Create API Key」按钮,开始创建一把新密钥。
第四步:选 Trading Account,把每一项权限都设成 Read Only
这是最关键的一步,请照下图逐项核对:
- API Key Remark(备注):输入好认的名字(例如
exagg demo)。 - IP Permissions(选填):留空即可,唯读密钥不强制绑 IP。
- Account Type(帐户类型):一定要选「Trading Account(交易帐户)」——选错成「Demo Account(模拟帐户)」会读到假数据,对不上你的真实资产。
- Permissions(权限):清单里的每一个项目——Spot Trading、Perpetual Futures、Delivery Futures、Stocks、Earn、Launch、Wallets、custody、Withdraw、Options、Subaccount、Commission Details——全部都要选「Read Only(唯读)」,不要留任何一项是可交易或可提现的权限。
确认整份清单右侧都显示「Read Only」后,按最下方的「Create API Key」,完成安全验证(2FA / 验证码),接着拷贝 API Key 与 Secret,贴回 ExAgg 的「添加交易所 → Gate.io」。
⚠️ 两个非设不可的重点:
- Account Type 必选「Trading Account(交易帐户)」——选成 Demo Account 会读到模拟帐户的假余额,永远对不上真实资产。
- 每一个权限项目都要调成「Read Only(唯读)」——上图那一整排(现货、合约、钱包、理财、提现…)无一例外全设唯读,不要留任何可交易或可提现的权限。唯读就足够追踪,把下单/提币能力交出去违反最小权限原则。
Gate 特有的注意事项
- 逐项设置是双面刃:粒度细,但也容易漏。口诀是「每一项都唯读,一项都不留空」。
- 接上后某块资产是 0? 回头检查那一项是不是留在「无权限」——这是 Gate 用户最常见的排查点。
- 不要图方便选读写:唯读就够追踪用了,读写等于把下单能力交出去,违反最小权限原则。
常见问题 FAQ
唯读密钥外流,Gate 的钱会被提走吗?
不会。全部设唯读的密钥,下单与提币请求都会被 Gate 服务器拒绝;对方最多看到余额与纪录。详见唯读 API Key 安全吗?。
为什么接上后合约(或理财)的资产是 0?
检查建密钥时该项权限是不是留在「无权限」。到 API Keys 页编辑密钥,把漏掉的项目改成唯读,或删掉重建一把全部唯读的。
密钥存在哪里?
只存在你手机的系统安全保存区(iOS Keychain / Android Keystore),不上传服务器。
怎么撤销?
登录 Gate → API Keys,删除该密钥即可立刻永久失效。
连好之后呢?
Key 贴进 ExAgg,Gate 的现货、合约、理财就会汇进同一个总资产数字。其他交易所接法:MEXC API Key 申请教学、KuCoin API Key 申请教学。