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密钥发起任何写操作。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











