只读API密钥仅支持行情与账户查询，须禁用交易/资金权限、启用IP白名单、设置30天有效期、强制校验User-Agent/Referer，并隔离测试与生产环境密钥。

欧易（OKX）官方认证入口：

点击获取官方APP☞☞☞☞☞：

API交易是通过程序接口连接交易所系统，实现自动获取行情与账户数据的技术方式。只读密钥仅允许查询操作，不涉及资金划转或订单提交。

一、理解只读API密钥的作用边界

只读API密钥用于限制外部程序对账户的访问权限，仅开放行情订阅、账户余额查询、持仓信息拉取等非执行类接口调用。该密钥无法触发下单、撤单、资金划转等敏感动作，从权限层面降低安全风险。

1、登录欧易官网，进入账户中心的安全设置页面。

2、点击API管理，选择创建新API密钥。

3、在权限配置界面中，取消勾选“交易权限”与“资金权限”选项，仅保留“查看账户信息”和“查看行情数据”。

4、完成短信或谷歌验证后，系统生成只读密钥对，立即复制并离线保存Key值。

二、启用IP白名单限制调用来源

IP白名单可强制API请求必须来自预设的固定出口IP地址，有效阻止异地或未知网络环境下的非法调用行为。即使密钥泄露，攻击者也无法绕过IP校验发起请求。

1、在API密钥创建流程的高级设置中，找到“IP白名单”输入框。

2、填入你部署监控脚本的服务器公网IP，不可留空或填写0.0.0.0/0。

3、如需多IP支持，使用英文逗号分隔，例如：192.168.1.1,203.0.113.5。

4、确认提交后，该密钥仅接受来自所列IP的HTTP请求，其余请求将被网关直接拒绝。

三、配置密钥有效期与轮换机制

设定明确的有效期可缩短密钥生命周期，配合定期轮换策略，大幅压缩密钥被滥用的时间窗口。欧易支持为每个API密钥单独设置过期时间，最长不超过90天。

1、在创建密钥页面下拉至“有效期设置”，选择具体天数，建议设定为30天。

2、到期前72小时，系统将在账户通知中心推送提醒。

3、新建替代密钥并完成配置后，立即禁用旧密钥，不可延迟停用。

4、更新所有调用端程序中的密钥参数，确保无缝切换。

四、禁用User-Agent伪造与Referer校验绕过

欧易API网关默认校验请求头中的User-Agent与Referer字段，防止脚本伪装成浏览器或跳过来源限制。关闭此类校验会扩大攻击面，必须保持启用状态。

1、进入API管理控制台，定位已创建的只读密钥条目。

2、点击“编辑”，检查“安全增强选项”是否显示为“已启用”。

3、确认“强制校验User-Agent”与“强制校验Referer”两项均处于开启状态。

4、若发现任一选项为关闭，立即启用并保存配置，旧请求将按新规则重新校验。

五、隔离测试与生产环境密钥

测试环境与生产环境共用同一密钥会导致权限混淆与审计失效。欧易支持为不同用途创建独立密钥，便于追踪异常调用来源并实施分级管控。

1、为本地调试创建名为“dev-read-only”的密钥，权限范围限定为测试合约对。

2、为线上监控服务创建名为“prod-market-watch”的密钥，绑定专属服务器IP。

3、两个密钥不得交叉使用，且命名中须包含环境标识。

4、在欧易API日志中，可通过密钥名称快速筛选对应环境的全部调用记录。