欧易 · 资金路径
欧易充币进哪个账户、怎么划转:量化资金的进出路径与 API 权限
钱充进了欧易,脚本读到的余额却是零;想把一部分利润拿出来,发现它被网格占着。量化资金在欧易里要过几道门:充币落到哪个账户,怎么划到下单用的交易账户,怎么分给子账户,被机器人占用的部分在哪看,最后才是提币。
充进欧易的币先到哪个账户
可以自己选。帮助中心《如何充币 (Web 端)?》的步骤是:【资产管理】-【充币】,选币种和网络,然后在页面下方的【充币账户】里点选充到【资金账户】还是【交易账户】。API 文档里「获取充值地址信息」返回的 to 字段对应的就是这个选择:6 是资金账户,18 是交易账户,并注明「某些主体用户(如巴西)只支持充值到交易账户」。
到账要等链上确认,同一篇帮助页的说法是「通常当该币种的区块确认数全部完成确认后便会显示充值成功」。
资金账户、交易账户、子账户之间怎么划转
手动划转在网页或 App 上做;脚本里用的是「资金划转」接口:POST /api/v5/asset/transfer,限速 2 次/s。文档对它的概括是「支持母账户的资金账户划转到交易账户,母账户到子账户的资金账户和交易账户划转」。必填参数四个:ccy(币种)、amt(数量)、from(转出账户)、to(转入账户),后两个只有 6(资金账户)和 18(交易账户)两种取值。跨母子账户时再加 type 和 subAcct(子账户名称):
| 要做的事 | type | 文档注明谁的 Key 能调 | subAcct |
|---|---|---|---|
| 账户内划转(资金账户 ↔ 交易账户) | 0(默认) | 未加限定 | 不用填 |
| 母账户转子账户 | 1 | 母账户 API Key | 必填 |
| 子账户转母账户 | 2 | 母账户 API Key | 必填 |
| 子账户转母账户 | 3 | 子账户 API Key | 不用填 |
| 子账户转同一母账户下的其他子账户 | 4 | 子账户 API Key,且母账户要先放开主动转出权限 | 必填 |
文档给的第一个示例,是母账户把 1.5 USDT 从资金账户划到交易账户:
POST /api/v5/asset/transfer
{
"ccy": "USDT",
"amt": "1.5",
"from": "6",
"to": "18"
}
有两处容易漏。一是文档在这个接口下提醒「请求的成功或失败不一定反映实际的划转结果」,建议调「获取资金划转状态」(GET /api/v5/asset/transfer-state,可查最近 2 个星期内的记录)确认。二是错误码 58111:「永续合约正在收取资金费,暂时无法做资金划转,请稍后重试」,脚本里对这个码安排重试。
母账户想直接指挥两个子账户之间互转,用的是另一个接口「子账户间资金划转」,文档注明仅适用于母账户。资金账户、交易账户、子账户各自是什么,见欧易资金账户和交易账户有什么区别。
策略机器人占用的资金怎么看
网格类机器人创建后,投入的钱不再算在交易账户的可用余额里。欧易《策略交易产品说明》写的是「网格创建后投入的资金会从交易账户中隔离出去,独立在网格策略中使用」,创建之后在交易页面下方的「策略」里查看和管理。定投相反,《现货定投》写明每期资金「不会从交易账户中隔离出去」,余额不够时怎么处理见欧易定投怎么设置。
用 API 看有两处:
- 「查看账户余额」(
GET /api/v5/account/balance)里每个币种的stgyEq(策略权益),旁边还有availBal(可用余额)和frozenBal(币种占用金额)。 - 「获取未完成网格策略委托单列表」里每个网格的
investment(累计投入金额)和totalPnl(总收益)。
被网格占着的钱要划走,得先让它回到交易账户。《现货网格》帮助页写的途径是停止策略,卖出所得返回交易账户;提取出来的网格利润也是转入交易账户。之后再按上一节的办法划转,能划多少看 availBal。
划转接口要什么权限
文档在资金划转接口开头写的是「调用时,API Key 需要有划转权限」。建 Key 时能勾的权限里并没有单独叫「划转」的一项:只有读取、交易、提现三种,划转归在交易权限里,文档对交易权限的说明把「转账」和下单撤单列在一起。所以一把只勾了读取和交易的 Key,已经能在资金账户和交易账户之间搬钱;它如果是母账户的 Key,还能往子账户搬、从子账户往回搬。
只读的 Key 划不了钱,拿来做监控和对账是合适的。跑策略的 Key 带着交易权限,要把它当成能动用这个账户全部划转路径的 Key 来保管;想让策略只碰得到一部分钱,办法是给它单开子账户、用子账户自己的 Key,原因在API 密钥泄露会发生什么里。
提币为什么不该给 API Key 开
文档对「提币」接口(POST /api/v5/asset/withdrawal)的说明是:「支持资金账户资产提币。普通子账户不支持提币。」另有一条:「API只能提币到免认证地址/账户上,通过 WEB/APP 可以设置免认证地址。」
不建议给跑策略的 Key 勾提现,理由有三条:
- 用不到。下单、撤单、查余额、划转,读取加交易两项权限就够。
- 它绕开了手动提币时的验证。帮助中心《如何提币?(Web端)》列的验证方式是通行密钥、手机、身份验证应用和邮箱的组合;API 调用凭的只是 Key 的签名。
- 读取和交易权限出事,钱还在你名下的几个账户之间;提现权限出事,钱离开欧易,上了链就撤不回来。
文档的 APIKey 安全性一节还有两条相关规则:建议给 Key 绑定 IP,每把最多 20 个;「未绑定IP且拥有交易或提币权限的APIKey,将在闲置14天之后自动删除」。提币建议留在网页或 App 上手动做。
常见问题
欧易充币时选资金账户还是交易账户?
充完马上要用脚本或机器人下单的,选交易账户,省一次划转;打算先放着、或者之后还要提走的,选资金账户,提币只支持资金账户里的资产。选了哪边都不是定死的,两个账户之间之后还能划转。
划转接口返回成功了,钱为什么没到?
文档在资金划转接口下提醒,请求的成功或失败不一定反映实际的划转结果,建议调「获取资金划转状态」(GET /api/v5/asset/transfer-state)确认,它能查最近两个星期内的划转。另外,错误码 58111 的含义是永续合约正在收取资金费、暂时无法划转,遇到就稍后重试。
只有交易权限的 API Key 能往子账户转钱吗?
能,前提是这把 Key 属于母账户。文档里交易权限包含「转账」;资金划转接口的 type 填 1 是母账户转子账户,注明仅适用于母账户 API Key,同时要在 subAcct 里填子账户名称。
网格机器人占用的钱能直接划回资金账户吗?
不能直接划。这笔钱在创建网格时已经从交易账户隔离出去。按欧易现货网格的帮助页,停止策略后卖出所得会返回交易账户,回到交易账户以后才能再划转。
用 API 提币需要什么条件?
需要 Key 带提现权限,并且文档写明 API 只能提币到免认证地址,免认证地址要先在网页或 App 上设置;普通子账户不支持提币。跑策略的 Key 用不到这项权限,建议不开,提币手动做。