量化喵是独立第三方信息站,与任何交易所都没有隶属关系。本页不含推广链接与邀请码。 完整披露 →

欧易 API · Key 管理

欧易 API Passphrase 忘了就只能新建一把 Key 换掉旧的

脚本换了一台服务器要重填配置,或者第三方量化软件要求重新绑定,填到 Passphrase 那一栏才发现想不起当初设的是什么。欧易帮助中心的回答是:Passphrase 是申请 API key 时填写的密码,需要自行记住,「一旦忘记,无法找回,您需要创建新的 API key」。

动手新建之前,到还在正常运行的那台机器上翻一遍:脚本的配置文件、.env、启动命令里带的环境变量。Passphrase 是调用私有接口的必要参数,脚本此刻还能查余额、能下单,这串字符就存在它读得到的某个地方,抄出来就不用重建。翻遍了也没有,再新建一把 Key,把脚本和软件里的三项凭证整组换掉,最后删除旧 Key。

这里的 Passphrase 只属于欧易的 API Key,App 创建页上叫【密码短语】。钱包助记词那边也有一个叫 passphrase 的设置,两者没有关系,去钱包里是翻不出来的。

欧易 API 的 Passphrase 填在创建 Key 页面的最后一栏

它是你在创建 API key 时自己输入的一串字符。App 和网页的入口不同,填写顺序一样:

  • App:登录后点左上角的九宫格,往下滑找到【API】,点【创建 API key】;依次填【备注名】,点选【账户】和【用途】,输入【IP 地址白名单】,点选【权限】,最后输入【密码短语】。
  • 网页:点右上角头像,进【API 与连接】,点【创建 API key】;前面几项和 App 相同,最后一栏的标签是【密码 (Passphrase)】。

App 上的「密码短语」和网页上的「Passphrase」是同一样东西。它跟你登录欧易账户用的密码无关,只跟着这一把 Key 走:每建一把新 Key 都要重新填一次,脚本调用接口时,它和 API Key、Secret Key 一起带上,缺了哪一样都过不了身份认证。

欧易 API 常见问题里对 Passphrase 的回答:申请 API key 时填写的密码,需要自行记住,忘记后无法找回、要创建新的 API key;下方是 App 端创建 API key 的入口与填写顺序
Passphrase 就是申请 API key 时自己填的那串密码,要自己记住;2026 年 11 月在 App 端创建 Key,填写顺序的最后一项正是【密码短语】。

API 管理页里能不能重新查看或修改 Passphrase?

已有的 Key 在【个人资料】>【API】里管理,点开列表里的某一把,能看能改的项目如下。旧 Key 删掉之前,顺手把能看到的几项抄下来,新建时照着填:

旧 Key 上的项目管理页里新建 Key 时怎么填
名称能看,能改起一个能和旧 Key 区分开的备注名,配置文件里用同一个名字标注
权限(读取、交易、提币)能看,能改照旧 Key 的勾选来,脚本用不上的权限这次就别勾
IP 白名单能看,能改把旧 Key 绑的地址照抄过去;每把 Key 最多 20 个,用逗号或空格隔开
Passphrase看不到,也改不了重新设一串新的,设完当场存进配置

中文帮助页「我如何管理或编辑 API key?」下面的注意事项是「创建后您无法查看助记词。如果丢失,您需要删除现有密钥并重新创建」。「助记词」三个字容易让人往钱包上想;页脚另有说明,很多页面是机器翻译,英文版才是官方文本。放回管理 API key 的上下文里读,它指的是这把 Key 的 Passphrase。

旧 Key 还在原来的机器上正常跑的,不必急着删。没跑的那种要留意:没绑 IP、又开着交易或提币权限的 Key,连续 14 天没有需要身份认证的调用就会被自动删除,脚本停了两周以上的,这把 Key 可能已经不在列表里了。

新 Key 建好、三项凭证换完之后再删旧 Key

顺序反过来,旧 Key 删了新 Key 又没调通,脚本会在中间断掉一段。照下面走:

  1. 确认账户能建新 Key。帮助中心写的是,创建 API key 要求账户的资产管理规模(AUM)大于 100U,主账户和子账户都按这条算。
  2. 按上表把旧 Key 的权限和 IP 白名单填进新 Key。IP 要不要绑、出口地址怎么查,见欧易 API Key 要不要绑 IP?不绑 IP 的交易 Key 14 天无活动会被删。
  3. 输入新的 Passphrase,建好后把新 Key 的 API Key、Secret Key 和这串 Passphrase 一起记下。
  4. 把所有用到旧 Key 的地方换成新的一组:每台服务器上的配置文件和环境变量、第三方量化软件里的绑定。只换 Passphrase 一项是不够的,新 Key 的 API Key 和 Secret Key 也都是新的。
  5. 在跑脚本的那台机器上,用新 Key 调一次需要身份认证的接口,比如查账户余额。返回 50119(API key 不存在)的,检查请求域名:EEA 用户要请求 eea.okx.com,美国用户要请求 us.okx.com,而不是 www.okx.com。
  6. 调通以后,停掉还在用旧 Key 的进程,再到【个人资料】>【API】点开旧 Key 删除。

新 Key 调接口报的是别的码,到《欧易 API 常见报错与排查清单:照着这张表修》里逐个查。旧 Key 留着不删也能用一阵,可它的 Passphrase 已经没人记得,又挂着交易权限,新 Key 调通以后就没有留它的理由了。

模拟盘 Key 和子账户 Key 的 Passphrase 要单独记

模拟盘的 Key 是另外建的:登录后进【交易】>【模拟交易】>【个人中心】>【创建模拟账户 API key】。实盘那把 Key 的 Passphrase 丢了,模拟盘这把照常能用;模拟盘那把丢了,也是回到这个入口另建一把,再把脚本里模拟盘的那组凭证整组替换。

重建之后两套凭证填反,接口返回 50101(APIKey 与当前环境不匹配)。实盘请求配实盘 Key,请求头 x-simulated-trading 填 0;模拟盘请求配模拟盘 Key,填 1。模拟盘下单报 50123,表示这把 Key 没有交易权限:新建时把交易权限勾上,并确认它是在 Demo Trading 环境下建的、请求的是你所在站点对应的 API 域名、每个模拟盘请求都带了 x-simulated-trading: 1。只有读取权限的 Key 能查账户数据,下不了单。模拟盘 Key 从创建到第一笔下单的完整过程,见欧易 API 量化入门:创建模拟盘 Key、下单与撤单核验。

子账户的 Key 要在目标子账户下创建,用这个子账户自己的权限、密码短语和站点域名,母账户和子账户的 API Key、Secret、密码短语不要混着填。子账户那把的 Passphrase 忘了,新 Key 同样回到那个子账户下建。

新设的 Passphrase 怎么存才不会再丢?

输入新 Passphrase 的同时,把它写进跑脚本那台机器的配置文件或环境变量,再留一份离线备份,写在纸上或存进本机加密的文件都行。两处都用 Key 的备注名标明是哪一把;实盘、模拟盘、子账户各有一把 Key 的,配置里分开命名,三组凭证别互相覆盖。

放 Passphrase 的配置文件不要提交进 Git 仓库,也不要贴进聊天窗口或截图发给别人。打包镜像、拷贝整个项目目录到新机器时,看一眼这个文件是不是跟着被带走了。

Passphrase 要和 API Key、Secret Key 配在一起才调得通接口,三样都落到别人手里,对方就能在这把 Key 的权限范围内调用接口。权限怎么收到够用为止,见API 密钥泄露会发生什么:权限设计与最小授权。

风险提示:API Key、Secret Key 和 Passphrase 三项同时泄露,对方可以按这把 Key 开着的权限读取账户、下单,带提币权限的还能转走资产;用不到的权限不要开。本文是 API 操作说明,不构成投资建议;自动交易同样可能亏损,请只用能承受全部损失的资金,并遵守所在地的法律法规。

Passphrase 找不回,也不耽误把脚本切到新 Key 上

忘记 Passphrase 的旧 Key 还能接着用吗?

已经配好它的脚本照常能用,忘掉的是你记着的那一份,脚本配置里那一份还在起作用。麻烦在于它填不进新的地方;另外,没绑 IP、开着交易或提币权限的 Key 连续 14 天没有需要身份认证的调用会被自动删除,旧脚本停着的话,早点换上新 Key。

第三方量化软件绑新 API Key 时报 50110 怎么办?

可能是当前 API key 的类型和这个软件的绑定方式不兼容。可以试着申请交易类型、不绑定 IP 列表的 Key,再重新连接软件。这样的 Key 没有 IP 白名单挡着,提币权限就别勾,Passphrase 照样当场存好。

找欧易客服能找回 API Passphrase 吗?

这串字符没有找回渠道,问客服也拿不到。向 API 客服反映接口用不了时,给出接口、HTTP 方法、完整错误码或消息、发生时间、账户站点和网络环境,再附上脱敏后的请求和响应;API Secret、Passphrase、认证码和未脱敏的签名任何时候都不要发出去。

欧易 API Key 最多能绑几个 IP?

每把 Key 最多关联 20 个 IP 地址,填的时候用逗号或空格隔开。新 Key 替换旧 Key 时把旧 Key 绑的地址照抄过去;脚本换了服务器的,把新服务器的出口地址也加进去。

创建欧易 API Key 有什么门槛?

帮助中心写的是账户的资产管理规模(AUM)要大于 100U 才能创建 API key,主账户和子账户都按这条算。旧 Key 删掉之前先确认账户够这个门槛,免得旧的删了、新的建不出来。