欧易 API 权限,简单说就是一把 API Key 能做什么、不能做什么的边界。它不是账户本身的权限,而是专门给程序调用接口时使用的一组能力开关。创建 API Key 时选择哪些权限,决定了这个密钥后续能读取数据、能下单,还是能碰资金。
权限解决的是“程序该有多大权力”的问题
手动交易时,用户登录账户、点击买卖,账户权限天然完整。但一旦把交易交给脚本、机器人或第三方工具,问题就变了:工具需要调用接口,而接口凭密钥识别身份。如果密钥拥有账户的全部能力,那么密钥泄露就等于账户被接管。API 权限的作用,就是把这种“全有或全无”拆成可选择的档位。
根据欧易公开的经纪商文档,API Key 的权限字段至少包含 read_only(读取)和 trade(交易)两类。read_only 是默认拥有且不可去除的,trade 则需要主动勾选。这意味着任何一把密钥都至少能读取信息,而是否允许交易由创建者决定。文档中创建子账户 API Key 的示例,权限值写作 read_only,trade,说明这两项可以组合授予。
读取和交易之外,还有更敏感的动作
欧易经纪商文档在创建子账户 API Key 时提到,未绑定 IP 且拥有交易或提币权限的 API Key,会在闲置 14 天后自动删除。这句话透露了两个信息:一是权限不止读取和交易,提币属于另一类更敏感的能力;二是平台会用闲置清理来降低长期不用的高风险密钥留存。
对普通使用者来说,这意味着权限选择不是“勾得越多越方便”,而是按任务需要来。只做行情查询和账户对账的脚本,读取权限就够;需要自动下单的策略,才加上交易权限;提币权限则应视为最高风险档位,除非确有自动化资金划转的明确需求,否则不轻易授予。
权限之外,还有几道配套的限制
权限不是孤立存在的。欧易文档中,创建 API Key 时可以绑定 IP 地址,多个 IP 用半角逗号隔开,最多支持 20 个。文档明确写“安全性考虑,推荐绑定 IP”。绑定后,只有来自这些地址的请求才会被接受,这相当于在权限之外再加一道来源限制。
另一个配套机制是限速。经纪商相关接口普遍标注了调用频率,例如获取子账户列表限速 10 次/秒,创建子账户 API Key 限速 40 次/秒,生成交易明细下载链接限速 1 次/小时。权限决定“能不能做”,限速决定“能做多快”。两者共同约束程序的行为,避免单个密钥对系统造成过大压力。
经纪商场景把权限问题放大了
欧易的经纪商体系里,权限设计体现得更明显。全披露经纪商分为 API 经纪商和 OAuth 经纪商两种模式。API 经纪商的流程是:用户在欧易申请 API Key 并提供给经纪商,经纪商通过 Broker code 加用户 API Key 下单。OAuth 经纪商则通过一键授权完成对接,用户无需提供 API Key 或登录密码。
OAuth 模式下,文档列出的权限同样只有 read_only 和 trade 两项,并注明“不包含子账户模块”。这说明即便是授权登录,平台也在把权限收窄到读取和交易,而不是把账户管理能力一并交出。文档还提到,OAuth 的访问令牌有效期 1 小时,刷新令牌有效期 3 天,一旦刷新,旧令牌无论是否过期都不再有效。这类时效设计,和权限一样,都是在缩小密钥或令牌被滥用的窗口。
权限不是安全保证,只是风险控制的一环
需要说清楚的是,权限设置得再细,也不能替代其他安全习惯。读取权限虽然不能直接下单或提币,但仍可能暴露账户信息;交易权限被滥用,可能产生非预期的订单;IP 绑定能限制来源,但绑定地址本身也需要妥善管理。权限的价值在于:当密钥意外泄露时,攻击者能做的事情被限制在已授予的范围内,而不是整个账户。
反过来,也不能因为某个密钥只开了读取权限,就认为它完全没有风险。权限是必要条件式的防护,不是充分条件。真正决定安全水平的,是权限、IP 绑定、密钥保管和定期检查共同作用的结果。
结论
欧易 API 权限要解决的,是程序化工具接入账户时的权力分配问题。它把账户能力拆成读取、交易、提币等档位,让使用者按任务授予最小必要权限,再配合 IP 绑定和调用限速,把密钥泄露后的影响面压到可控范围。理解这套权限逻辑,比记住某个具体勾选项更重要:先想清楚工具要做什么,再决定给它多大的权力。