想高效对接欧易 数字资产 流动性?本篇浓缩干货带你秒懂 API 接入、返佣设置、DMA / FD 经纪商 及 OAuth 一键授权 核心要点,助你快速上线一站式交易服务。
目录
三步成为欧易经纪商
1. 业务场景自检
凡是聚合交易、量化机器人、跟单社区、策略超市、资管 Saas 等与 数字资产 相关的平台都可申请。
👉 想了解返佣上限?先睹为快官方最新政策!
2. 在线申请通道
- 进入 经纪商主页 → 「立即申请」
- 如实填写:平台名称、业务规模、官网/应用链接、预计日活
- 2 个工作日内邮件反馈审核结果
3. 资料补充
审核通过后,官方将通过客户经理发送:
- 专属 BrokerCode(后续返佣凭证)
- DMA / FD 模式详细文档
- 技术对接群邀请
返佣逻辑与 tag 设置
订单与经纪商之间的关联,仅依赖一个字段:tag。
- 每次下单在请求体内补全
"tag":"你的BrokerCode" - 系统实时统计:交易量、手续费、应得佣金
返佣 T+1 结算至母账户,支持 USDT 或币本位结算
⚠️ 若漏写 tag,订单将归类为“自然流量”,无法追补返佣。
常用接口速查表
| 场景 | 端点 | 关键字段 |
|---|---|---|
| 现货下单 | POST /api/v5/trade/order | side,instId,tag |
| 网格策略 | POST /api/v5/tradingBot/grid/order-algo | algoOrdType,tag |
| 定投策略 | POST /api/v5/tradingBot/recurring/order-algo | recurringTime,tag |
| 大宗询价 | POST /api/v5/rfq/create-rfq | counterParts,tag |
多通道下单时可采用“批量下单”端点一次性写入多笔 tag。
DMA 深度玩法:子账户 & APIKey
获取子账户列表
GET /api/v5/broker/dma/subaccount-info- 必带参数:无
- 可选:分页 page、limit(最多 100 条)
- 返回字段:
uid|subAcct|enable|canTransOut
创建子账户的 APIKey
POST /api/v5/broker/dma/subaccount/apikey- subAcct:6-20 位字母数字
- passphrase:≥8 位,大小写+数字+特殊字符
- perm:
read_only,trade(推荐组合) - ip:绑定不超过 20 个 IP,为 数字资产 安全加保险
响应示例 200 OK
{
"apiKey": "****",
"secretKey": "****",
"passphrase": "******",
"perm": "read_only,trade"
}一键下载交易明细
- 生成链接
POST /api/v5/broker/dma/trades - 获取链接
GET /api/v5/broker/dma/trades?type=false&begin=20240401&end=20240410 - 保留 9 小时;CSV 内含标准化字段:
instId|ordId|fee|brokerRebate
全披露经纪商:API vs OAuth 双模式
| 维度 | API 经纪商 | OAuth 经纪商 |
|---|---|---|
| 用户授权 | 用户提供 APIKey | 一键 OAuth 登录 |
| 安全性 | 服务端托管 | 用户侧授权,无密码 APIKey |
| 适用平台 | 有服务器后端 | App、轻量级网页 |
| 返佣上限 | 与 API Broker 相同 | 与 API Broker 相同 |
OAuth 快速接入 4 步曲
- 申请 成为 OAuth 服务商 → 获取
client_id/client_secret - 拼接授权 URL 并跳转至欧易
- 回调换码:拿到授权码后换 access token
- 下单写 tag:每笔请求附带
"tag":"BrokerCode"
FAQ|高频疑问当场答
Q1:BrokerCode 可以修改吗?
A:一经分配不可修改,如特殊情况需更换,请提交工单说明。
Q2:返佣何时到账?
A:每日 08:00 (UTC) 自动结算,可直接在「资金记录」查看 USDT 余额。
Q3:同一个用户注册多个子账户返佣如何计算?
A:系统按 UID 汇总每日总手续费后再结算,跨账户不重复计费。
Q4:开通 DMA 后能否再转做 FD?
A:支持,但需重新申请审核,原 BrokerCode 失效。
Q5:调用接口出现 53013「接口权限不足」?
A:多半是 APIKey 权限不足,确认 perm 包含 trade 并且已绑定 IP。
Q6:CSV 下载链接生成失败?
A:检查三点:
- 日期格式
YYYYMMDD; - 起止区间 ≤ 90 天;
- 次数未超(DMA 每小时限 1 次,FD 每小时限 1 次)。
将以上内容对照代码逐条实现,即可获得完备的 欧易 API 接入 能力,不论是 返佣追踪 还是 用户增长,一站式全搞定!