OKX API权限分读取、交易、提现三类且不可叠加，须按需勾选；IP白名单为强制策略，未绑定则拒绝请求；MAC绑定限桌面端；测试与生产环境通过flag参数隔离；多角色应分设独立密钥。

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

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

一、OKX API权限分类与设置逻辑

OKX V5 API将权限划分为读取、交易、提现三类，权限不可叠加授权，必须按需勾选。读取权限仅允许查询账户余额、订单历史、行情数据等只读操作；交易权限在读取基础上开放下单、撤单、批量委托等写入能力。提现权限独立存在，且严禁在量化场景中启用。

1、登录OKX官网，完成实名认证后进入“账户设置-我的API”页面。

2、点击“创建API”，在弹窗中填写名称（建议标注用途如“量化读取”或“现货交易”）。

3、在权限选项区域，仅勾选“读取”或“交易”其中之一，切勿同时勾选。

4、确认提交后，系统生成API Key、Secret Key与Passphrase三段密文，页面仅显示一次，请立即安全保存。

二、IP白名单绑定操作步骤

IP白名单是限制API调用来源的强制性安全策略，未绑定IP的API密钥默认拒绝所有请求。动态IP用户需配合DDNS服务或使用云服务器固定出口IP实现绑定。

1、在“我的API”列表中，找到目标API密钥右侧的“编辑”按钮。

2、勾选“启用IP白名单”，输入你的服务器公网IP地址（格式如：203.208.60.1）。

3、若需允许多个IP，用英文逗号分隔，例如：203.208.60.1,119.75.217.10。

4、点击“保存更改”，系统将立即生效，此前未绑定IP的请求将返回错误码“50115”。

三、MAC地址绑定（仅限Windows/macOS客户端）

OKX支持对桌面端API密钥追加MAC地址校验，形成设备级访问控制。该功能适用于本地Python脚本部署场景，可防止密钥被复制到其他机器运行。

1、在创建API密钥的弹窗中，展开“高级设置”选项。

2、勾选“绑定MAC地址”，系统自动读取当前设备网卡物理地址。

3、如需手动输入，执行命令获取MAC：Windows用ipconfig /all，macOS用ifconfig | grep ether。

4、保存后，该API密钥仅可在指定MAC地址的设备上通过签名验证。

四、测试环境与生产环境隔离配置

OKX通过flag参数区分沙箱与正式环境，避免误操作导致真实资产变动。测试环境不校验IP白名单与MAC绑定，但返回模拟数据。

1、在Python初始化客户端时，设置flag参数：flag="1"为测试环境，flag="0"为生产环境。

2、测试环境API密钥无需绑定IP，但必须使用OKX提供的测试网络域名api-demo.okx.com。

3、生产环境密钥一旦绑定IP，修改IP需重新生成密钥，原密钥立即失效。

五、多角色密钥分离实践方案

量化系统常需同时运行监控模块与执行模块，应为不同功能分配独立密钥，实现最小权限原则。监控模块仅需读取权限，执行模块需交易权限，二者密钥互不共享。

1、创建第一个API密钥，仅勾选“读取”，命名为“monitor_read”，绑定监控服务器IP。

2、创建第二个API密钥，仅勾选“交易”，命名为“executor_trade”，绑定策略服务器IP。

3、在代码中分别加载两组凭证：monitor_api = AccountAPI(read_key, read_secret, read_pass, False, "0")。

4、执行模块调用TradeAPI时，传入executor_trade凭证，禁止复用monitor_read密钥发起任何写操作。