关键词：欧易 V5 API、统一账户、子账户、杠杆倍数、持仓模式、WebSocket、REST API、账户安全、币币杠杆、跨币种保证金
引言
欧易同步上线「统一账户」后，API 也从 V3 升级至 V5。新的接口思路更简单、字段更精简、功能更强悍。本章聚焦「交易前的账户层面准备工作」：从子账户管理、API Key 安全，到持仓模式、杠杆倍数的逐项配置，帮你一次到位。
👉 想体验极速 API 行情？点击查看官方统一账户 Demo！
V5 API 关键升级速览
- 统一 REST 域名：无论现货、永续、币本位，下单仅需
POST /api/v5/trade/order。 - 驼峰缩写：例如
instrument_id→instId，节省流量 20% 以上。 - 标准 WebSocket 压缩：原生支持
permessage-deflate，无需手动解压。 公共 / 私有频道分离：
- 公共频道：
wss://wspap.okx.com:8443/ws/v5/public - 私有频道：
wss://wspap.okx.com:8443/ws/v5/private
- 公共频道：
- WebSocket 高频下单：推送式新开仓、改仓、撤单，延迟低至 10 ms。
子账户与 API Key 管理
创建与管理一步到位
V5 允许用程序化方式“增删改查”子账户的 API Key，把安全粒度做到极致。
| 操作 | HTTP 方法与端点 |
|---|---|
| 创建 | POST /api/v5/users/subaccount/apikey |
| 查询 | GET /api/v5/users/subaccount/apikey |
| 更新 | POST /api/v5/users/subaccount/modify-apikey |
| 删除 | POST /api/v5/users/subaccount/delete-apikey |
安全 Tips
- 强制绑定固定 IP；未授权 IP 会返回
403错误。 - 最小授权原则：为子账户舍弃提币权，加速风控过审。
- 轮换周期：建议 90 天更换一次密钥，用脚本续命无感切换。
账户配置全景图
1. 获取当前配置
GET /api/v5/account/config返回包含四项关键配置：
- 账户模式（现货 / 现货+合约 / 跨币种保证金）
- 持仓模式（单向 / 双向）
- 自动借币开关（仅跨币种支持）
- 期权希腊值输出格式（PA / BS）
2. 持仓模式切换
单向持仓 = 同时只能有一个方向的仓位，适合趋势策略；
双向持仓 = 可同时多空对锁，适合量化套利。
切换前需全部平仓，接口如下：
POST /api/v5/account/set-position-mode
{"posMode": "long_short_mode"} # 双向
{"posMode": "net_mode"} # 单向3. 网页专属开关
- 账户模式、自动借币 不能在 API 设置，须在网页端完成——可在统一账户管理页面一键迁移，迁移期间 API 报单会被短时挂起。
杠杆倍数：单产品级配置
查询
GET /api/v5/account/leverage-info?instId=BTC-USDT返回所有已设置杠杆的产品列表，无设置时为默认值。
设置
POST /api/v5/account/set-leverage
{
"instId": "BTC-USDT",
"lever": "3.0",
"mgnMode": "cross" # cross/isolated
}分层设置示例
- 币币杠杆：按“币种”（BTC、USDT、LTC）设一次即可。
- 交割合约：只给其中某一合约设置杠杆即可同指数共享。
- 永续合约：与交割“独立开关”，需单独执行
set-leverage。
全场景配置案例
假设策略需求：
- 账户模式：跨币种保证金
- 持仓模式：单向
- 杠杆倍数：3× 全仓
- 标的覆盖：BTC、ETH、LTC 现货、交割、永续
执行清单（脚本 2 分钟跑完）：
- 通过 REST 确认
posMode为net_mode。 POST /api/v5/account/set-leverage批量调用- BTC、USDT、ETH、LTC（币币杠杆层级）
- BTC-USD-230929、ETH-USD-230929、LTC-USD-SWAP（逐标的层级）
- 给每个产生的 API Key 绑定固定 IP，脚本回写审计日志。
FAQ
Q1：REST 报 4003：“invalid sign” 错怎么办？
A：确认服务器时间与 NTP 同步误差 < 30 s；再检查签名原文是否含多余空格或大小写错误。
Q2：跨币种模式是不是会提高爆仓风险？
A：跨币种会共享保证金，但有实时组合保证金率预警；把杠杆倍数控制在 5 倍以内可显著降低强平概率。
Q3：WebSocket 已连接，但收不到持仓推送？
A：私有频道需先 {"op":"login"} 成功；登录失败时频道会静默丢弃订阅消息而不报错。
Q4：为什么改杠杆时返回 32040：“position occupied”？
A：该合约当前存在持仓，需先平仓或保持相同杠杆倍数。
Q5：子账户能用母账户的 VIP 费率吗？
A：可以。费用级别以母账户为准，子账户挂单即刻享受同档折扣。
Q6：交易所是否会无感知撤销未成交 WebSocket 订单？
A：不会。若订单长时间（默认 6 小时）无活动，系统会自动失效并推送 order_status=canceled，前端应监听 order 频道做同步。
总结与预告
通过本文，你已掌握「子账户 + 统一账户 + 杠杆配置」的完整链路。下一篇将聚焦交易核心：如何用 WebSocket 下单、如何做进场与持仓维度对账，敬请期待！