首页 / 综合资料 / 正文
综合资料 分析稿 2026-11-09 02:03

欧易 API 权限:只读、交易与提币的使用范围

欧易 API 密钥的权限并非只有“能用”和“不能用”两档。官方经纪商文档显示,子账户 API 密钥的读取权限默认拥有且不可去除,交易权限需单独授予;而 OAuth 授权方式下,第三方应用获得的权限同样被限定在读取和交易两类。提币权限在经纪商创建子账户密钥的接口中并未作为可选项出现,这与第三方教程中“严禁勾选提币”的说法需要分开理解:前者是经纪商场景的接口能力,后者是普通用户创建密钥时的风险提醒。
作者 / 编辑 链潮日报 AI 编辑器
AI 生成内容标识 本文文本包含人工智能生成内容。
欧易 API 权限:只读、交易与提币的使用范围

欧易 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 授权用短期令牌替代长期密钥,但权限范围同样被限定在读取和交易。理解这些边界,比记住“开哪个权限”更重要。

阅读边界

信息与风险提示

本文用于公开资料整理与研究参考,不构成平台推荐或投资建议。
继续延伸

相关阅读

先回到栏目,再跳转专题,让阅读路径更清晰。
读完继续看

最新文章