KuCoin API Key 申请教学:唯读权限设置完整步骤(2026)

KuCoin 的资产想跟其他交易所一起看总额,申请一把唯读 API Key 即可:App 只能读取,下单、提币请求都会被 KuCoin 服务器挡掉,密钥外流也动不了钱(原理见唯读 API Key 安全吗?)。

KuCoin 跟 OKX、Bitget 一样是「三件套」交易所:除了 Key 和 Secret,还要一组自订的 API Passphrase。

还没有 KuCoin 帐号?先到 KuCoin 官方注册页完成注册。

申请步骤（手机 App）

以下用 KuCoin App 示范。若用网页版,流程相同:登录后进入「API 管理」(直接打开),一样创建 API-Based Trading 密钥、只留 General 读取权限即可。

第一步:点左上角头像

登录 KuCoin App,在首页点左上角的头像,展开帐户菜单。

第二步:在「More」区找到「API」

往下卷到「More」区块,点「API」。

第三步:点「Create API」

进入「API Management」页面,点右上角的「Create API」开始创建密钥。

第四步:选 API-Based Trading、设置名称与 Passphrase、只勾 General

在创建表单顶端选「API-Based Trading」分页(不是「Link Third-Party Apps」),然后:

• API Name:输入好认的名字(例如 Exagg demo)。
• API Passphrase:自己设置一组短语。这是 KuCoin 特有的第三样——API 调用都要用到它,忘了就得整把密钥删掉重建,务必记下来。
• API Restrictions:只留「General」(它预设就已勾选,说明写着「For read-only access… Order placement and withdrawals are not allowed.」唯读、不能下单提现)。「Spot Trading」「Margin Trading」「KuCoin Earn」这些交易类权限全部不要勾。

第五步:IP 选项后按「Next」并完成验证

往下卷到 IP 设置:想更保险可选「Restrict to Trusted IPs Only」并填入你的 IP;没有固定 IP 就选「Unrestricted」。选好按「Next」,再完成安全验证(2FA / 邮件或短信验证码)。

第六步:拷贝三项信息贴回 ExAgg

创建完成后,会显示 API Key、Secret、Passphrase 三项(Passphrase 就是你刚刚自订的那组)。三样一起拷贝,贴回 ExAgg 的「添加交易所 → KuCoin」,三格都要填,缺一项都连不上。

KuCoin 特有的注意事项

• Passphrase 是建密钥时自订的,不是登录密码;忘了无法找回,只能删除重建。
• 只留 General 就好:General 就是唯读权限,能读到主帐户、交易帐户与理财(Earn)余额。画面上的「KuCoin Earn」是订阅/赎回的操作权限,不是读取范围,不要勾,以免多开不必要的权限。
• 三件套一起贴:连接失败最常见的原因是漏贴 Passphrase 或贴错字段。

常见问题 FAQ

唯读密钥外流,KuCoin 的钱会被动吗?

不会。没开交易与提现权限的密钥,调用这些接口会被 KuCoin 服务器直接拒绝;对方最多看到余额与纪录。详见唯读 API Key 安全吗?。

API Passphrase 忘记了怎么办?

无法找回。到 API 管理页删除旧密钥,重建一把并记好新 Passphrase。

密钥存在哪里?

Key、Secret、Passphrase 都只存在你手机的系统安全保存区(iOS Keychain / Android Keystore),不上传服务器。

怎么撤销?

登录 KuCoin → API 管理,删除该密钥即可立刻永久失效。

连好之后呢?

三件套贴进 ExAgg,KuCoin 的主帐户、交易帐户与理财部位就会汇进总资产画面。其他三件套交易所的接法:OKX API Key 申请教学、Bitget API Key 申请教学。