- 网页端在「头像 → API 与连接 → 创建 API key」，App 端在「左上角九宫格 → API → 创建 API key」。
- 核心权限有三种：读取（查询）、交易（下单撤单）、提币（转出资产）；给第三方工具的 Key 永远不要开提币。
- 未绑定 IP 且带交易或提币权限的 Key，闲置 14 天会被自动删除；模拟盘 Key 不受此限制。
- Secret Key 和 Passphrase 等同于密码，丢失无法找回，泄露后应立刻删除 Key 重新创建。
本文目录 11
API Key 是让程序代替你访问欧易账户的「钥匙」：自己写脚本查行情、查余额、自动下单，或者把账户接入第三方交易工具，都需要先创建 API Key。它的权限很大，一旦设置不当或被泄露，损失可能和账号被盗差不多。本文按欧易官方文档和帮助中心（核对于 2026 年 10 月）整理申请步骤、每项设置的含义，以及最重要的安全原则。
API Key 只适合确实需要程序化交易的用户。只是手动买卖，不需要创建任何 API Key。
申请前要知道的
创建成功后，你会得到三样东西，缺一不可：
| 名称 | 由谁生成 | 作用 |
|---|---|---|
| API Key | 系统随机生成 | 相当于用户名，标识这把钥匙 |
| Secret Key | 系统随机生成 | 用来给每个请求签名，相当于密码 |
| Passphrase | 你自己设置 | 调用接口时必须提供的口令 |
另外，欧易帮助中心注明：账户资产规模（AUM）需超过 100 美元才能创建 API Key，主账户和子账户都适用。
在哪里创建 API Key
网页端：登录欧易，点击右上角头像 →「API 与连接」→「创建 API key」。
App 端：点击首页左上角的九宫格图标 → 往下滑，点击「API」→「创建 API key」。
创建时需要依次填写：
- 备注名：给这把 Key 起个名字，建议写明用途，例如「行情脚本」「某某工具」；
- 账户：选择 Key 归属的账户（主账户或某个子账户）；
- 用途：按页面提供的选项选择；
- IP 地址白名单：限制只有指定 IP 才能使用这把 Key（下文详解）；
- 权限：勾选这把 Key 能做什么；
- Passphrase（密码短语）：自己设置一个口令。
创建完成后，页面会显示 API Key 和 Secret Key。请立即妥善保存，之后无法再次查看 Secret Key；丢了只能删除重建。
权限怎么选
欧易 API Key 的核心权限有三种，一把 Key 可以同时拥有一种或多种：
| 权限 | 能做什么 | 建议 |
|---|---|---|
| 读取 | 查询账户余额、账单、订单历史等 | 只看数据的程序开这一项就够 |
| 交易 | 下单、撤单、划转、调整账户设置等 | 程序需要替你下单时才开 |
| 提币 | 把资产提到外部地址 | 自己用也尽量不开，第三方工具绝对不开 |
帮助中心还列出了几项更细的权限：划转（在你的账户之间转移资金，所有账户可见）、借币和赚取（只有账户具备相应功能资格时才显示）。帮助中心说明，原本已开启交易权限的 Key 会自动获得这三项权限；新建 Key 时按需勾选即可。
选择的原则只有一条：最小权限，程序需要什么就给什么，多一项都不给。
Passphrase 是什么
Passphrase 是你自己设置的一串口令，每次调用私有接口都要连同 API Key、签名一起发送。欧易只保存它加密后的哈希值，忘记后无法找回，只能删除 Key 重新创建。建议使用和登录密码不同的独立口令，并保存在密码管理器里。
IP 白名单与 14 天自动删除规则
绑定 IP 后，只有来自白名单 IP 的请求才会被接受。即使 Secret Key 泄露，别人从其他地方也无法使用。
- 每把 Key 最多可以绑定 20 个 IP 地址，支持 IPv4、IPv6 和网段格式，多个地址用逗号或空格分隔；
- 程序跑在云服务器上时，填服务器的固定公网 IP；
- 来自非白名单 IP 的请求会返回错误码 50110。
欧易对未绑定 IP 的 Key 有一条重要规则：未绑定 IP、且拥有交易或提币权限的 API Key，闲置 14 天后会被自动删除。只有调用了需要 API Key 鉴权的接口（如查询余额、下单）才算「使用过」；只调用公开行情接口，即使带上了 Key 也不算。WebSocket 只有登录那一步算使用。这类 Key 的最近使用记录，可以在安全中心查看。模拟盘的 API Key 不会被删除。
子账户 API Key
如果你用子账户隔离不同策略的资金，需要在目标子账户下创建 API Key，并使用这个子账户自己的 Key、Secret Key 和 Passphrase。主账户和子账户的凭证不要混用。一个子账户一把 Key，一个策略出问题时，影响范围就限制在这个子账户的资金内。
模拟盘 API Key
建议先在模拟盘里把程序跑通，再考虑实盘。模拟盘的 Key 需要单独创建，路径是：
登录欧易 → 交易 → 模拟交易 → 个人中心 → 创建模拟账户 API key
调用时，请求头要加上 x-simulated-trading: 1。实盘 Key 和模拟盘 Key 不能混用，用错环境会返回错误码 50101。具体写法见 欧易 API Python 教程。
API Key 安全清单
- 永远不给第三方工具开提币权限。欧易帮助中心也明确提示，下单和管理订单都不需要提币权限；
- 能绑 IP 就绑 IP，这是 Secret Key 泄露后的最后一道防线；
- Secret Key 和 Passphrase 等同于密码：不要发到聊天群、截图、工单里，也不要直接写进代码上传到网上，推荐存放在环境变量或密码管理器中；
- 一个工具一把 Key，停用某个工具时直接删除对应的 Key，不影响其他程序；
- 定期清理：在 API 管理页面查看所有 Key，删除不再使用的；
- 怀疑泄露就先删除：先在欧易删除这把 Key，再创建新的，删除后对方立刻无法再操作你的账户；
- 账户本身的安全同样重要，务必开启通行密钥或身份验证 App，见 欧易账户安全设置教程。
警惕「量化机器人」骗局
API 相关的诈骗大多打着「量化」「AI 机器人」「稳赚套利」的旗号，常见套路包括：
- 在社群里推广「保证收益」的机器人，要求你创建带提币权限的 Key 并发给对方；
- 以「托管代操作」为名，索要 Secret Key、Passphrase 甚至登录验证码；
- 诱导你下载来路不明的「量化软件」，窃取 Key 或账户信息；
- 用不明来源的「回测截图」证明收益，再让你充值或转账。
没有任何机器人能保证盈利。要求你开提币权限、交出 Secret Key 或承诺固定收益的，都应该直接拒绝。对方自称欧易官方时，可以在欧易官网的「官方渠道验证」页面核实。
下一步
- 用代码调用 API：欧易 API Python 教程
- 不写代码也能用的自动化工具：欧易策略交易新手教程
- 术语速查：API Key 是什么
常见问题
欧易 API Key 在哪里申请？
网页端登录后点击右上角头像，进入「API 与连接」，选择「创建 API key」；App 端点击左上角九宫格，往下滑找到「API」，再点「创建 API key」。欧易帮助中心注明，账户资产规模需超过 100 美元才能创建 API Key，主账户和子账户都适用。
Passphrase 忘了怎么办？
Passphrase 是你创建 API Key 时自己设置的密码，欧易只保存加密后的结果，无法帮你找回。忘记后只能删除原来的 Key，重新创建一个。
为什么我的 API Key 突然失效了？
常见原因是这把 Key 没有绑定 IP，又开了交易或提币权限，连续 14 天没有调用需要鉴权的私有接口，被系统自动删除。绑定 IP 可以避免这种情况。此外，Key 被手动删除、权限被修改，或者调用时用错了实盘/模拟盘环境，也会导致报错。
第三方量化工具需要哪些权限？
只看行情和账户数据的工具，开「读取」即可；需要替你下单的工具，再加「交易」。任何第三方工具都不需要「提币」权限，对方如果要求开启，基本可以判断存在风险。
模拟盘的 API Key 和实盘通用吗？
不通用。模拟盘 Key 要在模拟交易里单独创建，调用时请求头需带上 x-simulated-trading 1；用实盘 Key 访问模拟盘（或反过来）会返回 50101 环境不匹配错误。
欧易的界面、费率和规则会调整，如与本文不一致，请以欧易官网最新信息为准。