API 密钥是程序化交易、资产监控与策略执行的底层凭证。对于使用 欧易 OKX 的研究者与交易团队而言，创建密钥只是第一步，真正决定风险边界的是权限配置。密钥一旦泄露，攻击者可能利用交易权限恶意下单，或通过提币权限转移资产。因此，建议在 欧易 OKX 中遵循最小权限、IP 白名单、子账户隔离与定期轮换原则。以下从创建、权限和管理三个层面说明。
创建准备
在创建前，应先完成 欧易 账户注册、身份认证，并开启双重验证。建议为不同策略使用独立子账户，避免主账户密钥外泄。
若服务器具备固定公网 IP，创建时可直接加入白名单。若使用动态 IP，应优先申请只读权限，待网络环境稳定后再开放交易权限。
API 密钥通常由 API Key、Secret Key 与 Passphrase 组成。Secret Key 和 Passphrase 往往只在创建时显示一次，需妥善保存；遗失后通常无法找回，只能删除并重建。
创建路径
- 登录 欧易 OKX，进入个人中心或账户管理，找到 API 入口。
- 点击创建 API 密钥，选择 V5 API 类型，并按用途命名，例如 spot-readonly 或 futures-trade。
- 设置权限：读取、交易、提币按需勾选；仅做行情分析时，只勾选读取。
- 配置 Passphrase 与 IP 白名单，绑定服务器出口 IP。若暂时无法绑定，应清楚其风险更高。
- 完成邮箱、手机与谷歌验证码验证，提交后保存 API Key、Secret Key、Passphrase。
- 创建后先调用只读接口测试，确认权限生效，再逐步开放交易权限。
权限类型
| 权限 | 典型用途 | 风险等级 | 建议 |
|---|---|---|---|
| 读取 | 查询行情、余额、订单与持仓 | 低 | 默认开启，可独立用于监控 |
| 交易 | 现货、杠杆、合约下单撤单 | 中高 | 仅策略账户开启，绑定 IP |
| 提币 | 提币或资金转出 | 高 | 非必要不开启，配合地址白名单 |
权限越少，潜在攻击面越小。尤其是提币权限，不应为了方便长期开启。若策略需要自动划转，建议先确认 欧易 OKX 当前接口能力和风控要求，再设计独立子账户与限额机制。
权限管理
权限管理不是一次设置就结束，而是随策略生命周期持续调整。策略上线、服务器迁移、人员变动或第三方平台接入时，都应重新复核密钥权限。
| 管理动作 | 触发频率 | 主要目的 |
|---|---|---|
| 权限复核 | 每月或策略变更时 | 防止过度授权 |
| 密钥轮换 | 建议每 90 天 | 降低泄露后的影响 |
| IP 白名单 | 创建或迁移服务器时 | 限制调用来源 |
| 删除密钥 | 停用策略或人员变动 | 立即止损 |
在 欧易 OKX 的 API 管理页面中，通常可以编辑权限、删除密钥、查看绑定 IP 等。对于异常调用或可疑订单，第一步应是删除受影响密钥，而不是仅修改登录密码。随后检查 API 日志、提币地址白名单与账户双重验证状态。
安全实践
不要将 Secret Key、Passphrase 写入前端代码、公开仓库或聊天记录。生产环境应使用环境变量、密钥管理服务或独立配置文件，并限制服务器访问权限。
测试与生产密钥应分离。第三方量化平台若要求权限，应确认其只申请必要范围，并优先使用只读或受限交易权限。提币权限必须配合地址白名单和 IP 白名单，且定期检查。
若尚未完成账户准备，可通过 欧易 官方渠道注册并开启双重验证，再按上述流程创建 API 密钥。避免从非官方页面输入密钥或验证码。
常见误区
把 API 密钥当作普通账号密码，是常见错误。API 密钥用于程序调用，泄露后的处置方式与账号密码不同。另一个误区是“先开全部权限，后续再收紧”，这会在窗口期内放大风险。
更稳妥的做法是：默认只读，交易按需，提币关闭；所有密钥绑定 IP；为每个策略创建独立子账户与独立密钥；定期轮换并保留操作记录。若发生泄露，立即在 欧易 OKX 删除密钥、重建最小权限密钥，并检查账户资金与订单。
