只读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日志中,可通过密钥名称快速筛选对应环境的全部调用记录。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











