API Key是访问欧易OKX接口的身份凭证，用于身份验证、权限控制与计费；创建需登录账户中心→API管理→创建API→选权限→命名→设IP白名单→绑定谷歌验证器→下载保存Secret Key。
一、API Key的基本定义与作用
API Key是开发者访问平台接口时必需的身份凭证，表现为一串由字母和数字组成的唯一字符串。它用于验证调用来源、控制访问权限，并作为使用计量与计费的依据。
二、在欧易OKX创建API密钥的操作流程
欧易（OKX）官方认证入口：
点击获取官方APP☞☞☞☞☞：
创建API密钥需通过主账号或具备管理员权限的子账号完成，确保操作账户已通过高级身份认证。该过程不涉及资金授权，仅开通数据读取或交易指令权限选项。
1、登录欧易OKX官网，进入“账户中心”页面。
2、点击左侧菜单栏中的“API管理”，进入API设置界面。
3、点击“创建API”，选择所需权限类型：只读、交易、提现（提现权限需额外短信+谷歌验证码双重确认）。
4、填写API名称，建议使用带日期与用途标识的命名方式，例如“TradingBot_202603_SpotOnly”。
5、设置IP白名单，输入允许调用该密钥的固定公网IP地址，未填写则默认允许任意IP发起请求。
6、勾选“启用Google验证器”并完成绑定，系统将生成一对密钥：API Key与Secret Key。
7、立即下载并离线保存Secret Key文本，网页端不再提供二次查看机会。
三、欧易OKX API密钥的安全配置方法
安全配置的核心在于最小化暴露面与强化访问控制。所有密钥应遵循权限隔离原则，避免一个密钥承担多角色任务。
1、为不同用途分别创建独立API密钥，例如行情监控、自动挂单、跨市场套利各用一组密钥。
2、对仅需查询余额与订单状态的场景，严格禁用“交易”与“提现”权限。
3、启用IP白名单后，若使用云服务器部署策略，需填入该服务器的出口公网IP而非内网地址。
4、在“API管理”列表中，点击对应密钥右侧的“编辑”按钮，可随时修改IP白名单或禁用某项权限。
5、禁用“允许所有IP”选项，未设置白名单的密钥必须立即停用。
四、欧易OKX API密钥异常响应处理
当系统检测到非常规调用行为时，会触发风控机制自动暂停密钥功能。此时需人工介入核查，防止误判影响策略运行。
1、登录后查看“API管理”页，状态显示为“已冻结”的密钥需点击“申诉”提交说明。
2、准备近7日内该密钥的完整调用日志，包括时间戳、请求路径、返回状态码及User-Agent字段。
3、在申诉表单中明确说明调用场景，例如“每15秒调用/v5/market/ticker获取BTC-USDT最新价”。
4、上传服务器防火墙出站规则截图，证明请求源IP确属白名单范围。
5、申诉提交后等待2小时内人工审核，期间不可重复提交相同请求。
五、定期轮换欧易OKX API密钥的操作规范
定期更换密钥是降低长期泄露风险的有效手段，建议每90天执行一次主动轮换，旧密钥停用前须确保新密钥已全量测试通过。
1、提前3天创建一组新API密钥，权限与IP白名单配置完全复刻旧密钥。
2、在本地策略代码中替换API Key与Secret Key变量值，并在测试环境运行24小时验证稳定性。
3、确认无报错后，在生产环境切换密钥，同时记录切换时间点与版本号。
4、登录欧易OKX后台，将原密钥状态改为“已禁用”，不可直接删除以免丢失审计线索。
5、禁用后的密钥仍保留在列表中至少30天，供异常追溯使用。
