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

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

OKX 跟币安不同的一点:除了 Key 和 Secret,还要多设置一组 Passphrase(密码短语),三个一起才能用。

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

申请步骤（手机 App）

以下用 OKX App 示范。若用网页版,流程相同:登录后点右上角头像 →「API」(直接打开),一样创建唯读密钥即可。

第一步:打开左上角功能菜单

登录 OKX App,在首页「Exchange」分页点左上角的九宫格图标,展开全部功能。

第二步:进入 API

在展开的「More(更多)」清单里,点「API」(</> 图标)。

第三步:点「Create API key」创建密钥

进入 API 管理页后,每把密钥会显示用途(Purpose)、权限(Permissions)、创建时间等信息。点下方的「Create API key」开始新建一把。

第四步:命名、权限只选「Read」,并设置 Passphrase

在创建表单里:

• API name:输入好认的名字(例如 exagg demo)。
• Account:选「Main account(主帐户)」。
• Permissions:只点「Read(读取)」,「Withdraw(提币)」与「Trade(交易)」保持不选。
• Passphrase:往下卷动会要求你自订一组 Passphrase(密码短语)——这是你自己设置的,请务必记下来,OKX 之后不会再显示,连客服也查不到。
• Trusted IP access(信任 IP)非必填,唯读密钥可保持关闭。

完成安全验证后密钥就创建好。把 API Key、Secret、Passphrase 三个都拷贝,贴回 ExAgg 的「添加交易所 → OKX」——三样都要填,少一项都连不上。

OKX 特有的注意事项

• Passphrase 是自己设的,忘了救不回来:它不是登录密码,是建密钥时自订的短语。忘记就只能删掉密钥重建。
• 要建 V5 API:OKX 目前的 API 版本是 V5,追踪 App 都走 V5 接口,别选到旧版。
• 三件套缺一不可:Key、Secret、Passphrase 三项要同时贴进 App,常见错误是漏了 Passphrase 导致连接失败。

常见问题 FAQ

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

不会。唯读密钥调用下单或提币接口,OKX 服务器会直接回传权限错误。对方最多能看到你的余额与交易纪录,详见唯读 API Key 安全吗?。

Passphrase 忘记了怎么办?

无法找回,OKX 不会再显示,客服也查不到。处理方式:到 API 管理页删除旧密钥,重建一把并记好新 Passphrase。

密钥贴进 ExAgg 后存在哪里?

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

想撤销授权怎么做?

登录 OKX → API 管理页,删除该密钥即可立刻永久失效,重建也随时可以。

连好之后呢?

三件套贴进 ExAgg,OKX 的资产就会实时汇进总资产画面,跟币安、Bybit 放在同一个数字里看。其他交易所的接法:Binance 币安 API Key 申请教学、Bitget API Key 申请教学。