欧易(OKX)的 API 密钥在创建时需要选定权限,公开说明把权限分为读取、交易和提币三类。理解这三类权限各自允许什么操作,是判断一个 API 密钥能做什么、不能做什么的基础。
三类权限分别对应什么操作
读取权限允许外部程序读取账户数据。这类权限不涉及下单或资金转出,适合只需要获取账户信息的场景。
交易权限允许发送和撤销订单。也就是说,持有交易权限的密钥可以代表账户提交订单,也可以撤销已有订单。它改变的是订单状态,而不是直接划走资产。
提币权限允许通过 API 发起提币。公开说明在列出这一项时特别注明“请谨慎使用”,原因在于提币涉及资产离开账户,与读取和交易的性质不同。三类权限中,提币是唯一直接指向资金转出的权限。
密钥、密钥与密码短语是三样东西
在外部平台或工具中使用 API 时,需要填入三项信息:API 密钥、密钥(Secret Key)和密码短语。三者共同构成调用凭证,缺一不可。
密码短语是创建 API 时自行设置的密码。公开说明明确,密码短语如果遗失将无法找回。这意味着它不像普通登录密码那样可以通过找回流程重置,创建时的记录和保管需要提前考虑。
账户字段为什么有时不能选
创建 API 密钥时,页面上有一个账户字段。公开说明解释,这个字段是下拉菜单,只有当账户绑定了子账户时才会激活。如果使用的是未关联任何子账户的主账户,该字段会预设为主账户并锁定,这是正常现象,不是错误。此时保持该字段不变,继续填写密钥名称、权限和密码短语即可,系统会为主账户创建密钥。
这一细节说明,API 密钥可以绑定到主账户或子账户。子账户本身是关联在主账户下、用于分开管理不同交易活动的账户,标准用户最多可创建 5 个子账户。把密钥绑定到哪个账户,决定了这个密钥操作的是哪个账户范围内的数据与订单。
账户模式不能通过 API 更改
公开说明还提到一个与 API 相关的限制:账户模式决定了可交易的产品和市场,例如现货和合约,而账户模式须在使用前完成配置,且无法通过 API 更改。
这一点容易被忽略。API 可以读取数据、发送订单,但不能替用户切换账户模式。如果外部程序的操作依赖某种账户模式,这个模式需要在创建或使用 API 之前就在账户层面设置好。
权限设置之外的安全提示
公开说明给出的安全建议包括:启用双重认证、将 API 使用范围限制为受信任的 IP 地址、撤销不再使用的 API 密钥。这些措施针对的是密钥被滥用的风险,与权限选择是两件事:权限决定密钥能做什么,IP 限制和撤销机制则缩小密钥被他人使用的可能。
需要区分的是,这些是平台公开说明中的建议,不构成对任何具体工具或使用方式的担保。权限选得再窄,密钥和密码短语本身仍需妥善保管。
结论
欧易 API 的三类权限中,读取对应账户数据,交易对应订单的发送与撤销,提币对应通过 API 发起提币,后者在公开说明中被单独提示谨慎使用。创建密钥时还需设置无法找回的密码短语,账户字段是否可选取决于是否绑定了子账户,账户模式则必须在 API 之外提前配置。把这些术语放回各自的操作范围,才能判断一个 API 密钥的实际能力边界。