欧易 API 的权限设置,核心区别在于“能读什么”和“能做什么”是分开授予的。读取权限负责查询账户、订单和行情,交易权限负责下单撤单,两者可以只开一个。至于提币,在欧易面向经纪商的子账户 API 密钥创建接口里,权限字段只列出了读取和交易两项,并没有把提币作为可勾选项。
读取权限为什么默认存在
根据欧易经纪商文档中“创建子账户的APIKey”接口的说明,权限参数 perm 的可选值为 read_only 和 trade,其中 read_only 是默认拥有且不可去除的。这意味着一个 API 密钥至少能读取数据,无法创建一个完全“什么都看不到”的密钥。
这个设计有实际原因:API 调用需要先确认身份和账户状态,读取权限是鉴权链路的基础。对使用者来说,只读密钥适合行情监控、资产看板、数据回测这类不需要动资金的场景。即使密钥泄露,对方也只能看到账户信息,不能下单或转走资产。
交易权限是单独加上的
交易权限需要显式授予。在同一个创建接口中,perm 写成 read_only,trade 才同时具备读取和交易能力。文档里给出的请求示例正是这个组合。
交易权限打开后,程序可以下单、撤单、查询订单状态。它不包含提币能力,也不包含子账户管理模块的权限。OAuth 经纪商文档的权限表同样只列了 read_only 和 trade 两项,并注明“不包含子账户模块”。这说明在欧易的经纪商授权体系里,第三方应用能拿到的权限范围被限定在读取和交易,而不是账户的全部功能。
提币权限为什么不在同一张表里
需要区分两个层面。经纪商创建子账户 API 密钥的接口,权限字段只有读取和交易,提币没有出现在可选值中。这是接口本身的能力边界,不是“提币被默认关闭”的开关说明。
而网上一些面向普通用户的教程会提醒“不要勾选提币权限”,那是针对用户在网页端自行创建 API 密钥时的界面选项。两者说的不是同一个入口:一个是经纪商通过接口为子账户生成密钥,一个是用户自己在账户设置里创建密钥。把前者的接口字段直接套到后者,或者反过来,都会造成误解。
IP 绑定和闲置删除是两回事
经纪商文档还提到两个与密钥生命周期有关的规则。第一,创建子账户 API 密钥时可以绑定 IP,多个 IP 用半角逗号隔开,最多 20 个;文档建议绑定 IP,但没有把它设为必填。第二,未绑定 IP 且拥有交易或提币权限的密钥,会在闲置 14 天后自动删除,模拟盘的密钥不受此影响。
这里要注意,自动删除针对的是“未绑定 IP 且具备交易或提币权限”的密钥,不是所有密钥。只读且未绑 IP 的密钥是否同样适用,文档没有在这句话里展开,不能直接类推。IP 白名单的作用是限制调用来源,它和权限大小是两个维度:权限决定能做什么,IP 决定从哪里能做。
OAuth 授权和 API 密钥不是同一种凭证
欧易的 OAuth 经纪商模式走的是另一条路。用户不需要把 API Key 交给第三方,而是在第三方应用里跳转到欧易完成授权,第三方拿到的是访问令牌和刷新令牌。文档写明访问令牌有效期 1 小时,刷新令牌有效期 3 天,刷新后旧令牌无论是否过期都不再有效。
这种模式下,第三方应用调用接口时在请求头里带 Authorization: Bearer 令牌,而不是用 API Key 加签名。权限范围同样限定在读取和交易。它解决的是“不想把长期密钥交给第三方”的问题,但授权本身仍然意味着第三方能在授权范围内操作账户,令牌泄露的风险并不会因为换了凭证形式就消失。
限速规则要按具体接口看
经纪商文档里每个接口都单独标注了限速和限速维度。例如获取子账户列表是 10 次每秒、按 User ID 限速;获取子账户交易手续费费率是 1 次每秒;创建子账户 API 密钥是 40 次每秒;生成交易明细下载链接是 1 次每小时。这些数字只对应各自接口,不能概括成“欧易 API 的统一限速”。
同样,文档中出现的费率字段正负号含义也需要按原文理解:正数代表返佣费率,负数代表平台扣除的费率。这是经纪商手续费查询接口的字段说明,不是普通用户交易手续费的通用规则。
结论
欧易 API 权限的关键区分是:读取权限默认存在且不可去除,交易权限需要单独授予,两者都不等于提币能力。经纪商子账户密钥接口没有把提币列为可选项,而普通用户自行创建密钥时的提币勾选是另一个入口,不能混为一谈。IP 绑定限制的是调用来源,闲置删除规则有明确的适用前提。OAuth 授权用短期令牌替代长期密钥,但权限范围同样被限定在读取和交易。理解这些边界,比记住“开哪个权限”更重要。