欧易(OKX)的 API 密钥不是一把万能钥匙,而是按权限拆分的凭证。创建密钥时,平台让用户勾选读取、交易、提币三类权限,每一类对应不同的操作范围。理解这三者的边界,比记住任何一条“安全建议”都更实用。
三类权限各自能做什么
读取权限只允许外部程序读取账户数据,例如查询余额、查看订单记录。这类密钥即使泄露,持有者也无法用它下单或转移资产。
交易权限允许发送和撤销订单。它管的是“买卖”这个动作,不涉及把资产转出账户。一个只有交易权限的密钥被滥用,可能产生不受控制的订单,但资产仍在账户内。
提币权限允许通过 API 发起提币。这是三类权限中影响最直接的一类,因为一旦被滥用,资产可能离开账户。平台在说明中对提币权限的提示是“请谨慎使用”,这并非客套话,而是权限设计本身的含义。
一个常见的误解是把 API 密钥等同于登录密码。登录密码配合双重认证可以进入账户界面,而 API 密钥是给程序用的凭证,它的能力完全由创建时勾选的权限决定。同一个账户可以创建多个密钥,分别授予不同权限,用于不同程序。
账户模式不能通过 API 更改
另一个容易混淆的点是账户模式。账户模式决定用户可以交易哪些产品和市场,例如现货和合约。根据欧易帮助中心的说明,账户模式须在使用前完成配置,且无法通过 API 更改。
这意味着,如果程序调用的接口与当前账户模式不匹配,问题不在密钥权限,而在账户本身的模式设置。把这类报错归因于“API 权限不够”,会让人在错误的方向上反复调整密钥。
子账户与密钥归属
API 密钥在创建时可以选择绑定主账户或某个子账户。子账户是关联到主账户的独立账户,可用于隔离不同的交易策略、管理多个交易机器人或独立控制风险。标准用户最多可创建 5 个子账户。
有一个细节值得注意:创建 API 密钥页面上的账户字段是一个下拉菜单,仅当账户绑定了子账户时才会激活。如果使用的是未关联任何子账户的主账户,该字段会预设为主账户并锁定。这是正常现象,不是错误,继续填写名称、权限和密码短语即可。
把主账户密钥和子账户密钥混用,是另一个常见误解的来源。密钥绑定哪个账户,就只能操作哪个账户范围内的数据与订单,不会因为主账户权限更高就自动覆盖子账户。
密码短语丢失无法找回
创建 API 密钥时会生成或设置三个要素:API 密钥本身、密钥(Secret Key)和密码短语。密码短语是创建时自定义的额外安全码,平台明确说明,如果遗失将无法找回。
这与“忘记密码可以重置”的日常经验不同。密码短语不是登录密码,没有找回流程。丢失后通常只能撤销旧密钥、重新创建。把密码短语记在随手可查的地方,或者与密钥明文存放在同一文件里,都会削弱它作为独立验证要素的意义。
IP 白名单是限制条件,不是绝对防护
将 API 使用范围限制为受信任的 IP 地址,是平台给出的安全建议之一。它的作用是把密钥的可用范围收窄到指定地址,即使密钥在别处泄露,非授权地址也无法直接调用。
但白名单不是“设了就万事大吉”。它限制的是调用来源,不改变密钥本身的权限。一个绑定了提币权限的密钥,在白名单内的机器上依然可以发起提币。白名单降低的是外部滥用概率,不是权限范围。
同样,撤销不再使用的密钥是平台建议的操作。撤销针对的是密钥凭证,不是账户本身,也不影响其他仍在使用的密钥。
模拟环境与实盘是两套状态
公开资料中常提到先在模拟交易环境测试代码逻辑,再接入实盘。这一点值得从权限角度理解:模拟环境和实盘环境是分开的,在模拟环境中验证通过的调用,不代表实盘账户的权限配置、账户模式或余额状态与之一致。测试通过只说明代码逻辑可行,不说明实盘密钥的权限刚好匹配。
结论
欧易 API 权限的核心边界可以概括为:读取管数据,交易管订单,提币管资产转出。三者独立勾选,按需授予。账户模式无法通过 API 更改,密码短语丢失不可找回,IP 白名单收窄调用来源但不改变权限本身。把这些边界分清,比笼统地记住“不要泄露密钥”更能帮助判断一个 API 配置实际暴露了什么。