使用 欧易 V5 API 的技巧和诀窍（1）

[

](/price/eos-eos) API密钥拥有账户完全控制权，泄露可能导致资产损失。务必：1) 绑定IP白名单；2) 只授予必要权限；3) 定期轮换密钥；4) 不在代码中硬编码。建议先在测试环境熟悉接口，再切换到生产环境。

引言

欧易V5 API上线了，相比V3有哪些改进？

最大的变化是"统一"：所有产品（现货、合约、期权）共用一套API，不再需要为每个产品写不同的代码。这篇文章会讲解V5的核心改动，以及如何快速配置账户。

V5 API 的改动

产品共用统一 API

V5 API 最大的改进是统一接口设计。无论现货、合约还是期权，都用同一个API下单。

V3 API（旧版）的问题：

POST /api/spot/v3/orders      # 现货下单
POST /api/futures/v3/order    # 合约下单
POST /api/option/v3/order     # 期权下单

每个产品需要不同的代码，维护成本高。

V5 API（新版）的解决方案：

POST /api/v5/trade/order      # 所有产品统一下单

只需在请求body中指定instType参数（SPOT/SWAP/FUTURES/OPTION），就能交易不同产品。代码量减少约40%，接口调用更简洁。

更短的命名规则

V5 API 采用驼峰式命名+缩写，节省带宽和内存。

对比示例：

| 字段 | V5 API | V3 API | 节省 | |------|--------|--------|------| | 币种 | ccy | currency | 60% | | 产品ID | instId | instrument_id | 46% | | 合约标的 | uly | underlying | 60% | | 未实现盈亏 | upl | unrealized_pnl | 73% |

高频交易场景下，这种优化能显著降低网络传输成本。

标准 WebSocket 数据压缩

V5 API 使用标准的”Per-Message Deflate”压缩扩展，收到数据后自动解压，无需手动处理。

V3 API的麻烦：

# 需要手动解压缩
import zlib
data = zlib.decompress(message)

V5 API的便利：

# 客户端自动处理，直接使用数据
# 请求头包含 “permessage-deflate” 即可

检查你的WebSocket客户端是否已启用压缩扩展，大多数现代库默认支持。

公共和私有 WebSocket

WebSocket 频道分为两类：

公共频道（无需登录）：

• 行情数据
• K线数据
• 交易深度

私有频道（需要登录）：

• 账户余额
• 持仓信息
• 订单更新

两类频道连接不同的URL。连接公共频道时不要发送登录请求，否则订阅会失败。这个设计提升了安全性，也降低了公共数据的访问门槛。

使用 WebSocket 下单

V5 API 新增了 WebSocket 下单功能，相比 REST API 有明显优势：

REST API：

• 每次下单需要建立HTTP连接
• 延迟约50-100ms
• 适合低频交易

WebSocket API：

• 保持长连接
• 延迟约10-20ms
• 适合高频交易

支持的操作：下单、改单、撤单。详细用法见API文档或本系列第2部分。

登陆

V5 API 的 REST 登陆和 V3 API 的一样（即在 REST 请求头上加上签名）。

V5 API 的 WebSocket 登陆也和 V3 API 的很类似（即传送登陆请求），只是在格式上改为键值对：

创建子账户的 API Key

使用母账户（主账户）时，可以通过 V5 API 管理子账户的 API Key。

支持的操作：

| 操作 | 接口 | |------|------| | 创建 | 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 |

安全建议：

1. 为每个API Key绑定IP白名单
2. 只授予必要的权限（读取/交易/提现）
3. 定期轮换API密钥
4. 不要在代码中硬编码密钥

配置账户

创建子账户和 API Key 后，需要配置账户参数。

账户配置

查看当前账户配置：

GET /api/v5/account/config

返回信息包括：

1. 账户模式（现货/现货合约/跨币种保证金）
2. 持仓模式（单向/双向）
3. 自动借币设置
4. 期权希腊值配置（PA/BS）

账户模式

欧易统一账户提供三种模式：

现货模式：只能交易现货 现货和合约模式：可同时交易现货和衍生品 跨币种保证金模式：使用多种币种作为保证金

账户模式只能在网页端更改，API无法修改。

持仓模式

欧易统一账户支持两种持仓模式：

单向持仓模式（买卖模式）：

• 只能持有多头或空头
• 系统根据持仓数量自动开平仓
• 适合单边趋势交易

双向持仓模式（开平仓模式）：

• 可同时持有多头和空头
• 需要手动指定开仓/平仓
• 适合对冲策略

设置持仓模式（需先平掉所有仓位）：

POST /api/v5/account/set-position-mode

注意：切换模式前必须清空所有持仓，否则会报错。

自动借币

自动借币是跨币种保证金模式下的功能，只限于在网页上更改。

期权希腊值 PA/BS

和 V3 API 相似，我们可以通过以下的 REST API 设置期权希腊值 PA/BS：

POST /api/v5/account/set-greeks

全仓/逐仓保证金模式

欧易统一账户的保证金设置更灵活，可以同时用全仓和逐仓交易同一产品。

全仓模式：

• 使用账户全部可用保证金
• 风险分散，不易爆仓
• 适合稳健交易

逐仓模式：

• 只使用指定金额作为保证金
• 风险隔离，最多损失保证金
• 适合高风险策略

V5 API 没有全局设置保证金模式的接口。需要在下单时通过tdMode参数指定（cross/isolated）。详见API文档或本系列第2部分。

杠杆倍数

获取杠杆倍数

查询当前杠杆倍数：

GET /api/v5/account/leverage-info

杠杆倍数没有全局设置，不同产品有不同的配置场景。

币币杠杆：

• 按币种设置（如BTC、ETH、USDT）
• 买入和卖出可以设置不同倍数

合约/永续：

• 按产品或标的指数设置
• 交割和永续分开独立设置

设置杠杆倍数

POST /api/v5/account/set-leverage

建议在交易前预先设置好每个产品的杠杆倍数，避免下单时因杠杆不足导致失败。

示例：

假设有以下配置需求：

账户设置：

• 账户模式：跨币种保证金
• 持仓模式：单向持仓
• 杠杆倍数：3.0倍
• 保证金模式：全仓

需要设置的产品：

• 现货杠杆：BTC-USDT、EOS-USDT、LTC-BTC、LTC-USDT
• 交割合约：BTC-USD-210319、BTC-USD-210326、BTC-USD-210625
• 永续合约：BTC-USD-SWAP

设置步骤：

第1步：设置币币杠杆

币币杠杆按币种设置，需要设置4个币种：BTC、USDT、EOS、LTC。

设置BTC币种杠杆为3.0倍（适用于卖出BTC-USDT和买入LTC-BTC）：

{
  "ccy": "BTC",
  "lever": "3",
  "mgnMode": "cross"
}

USDT、EOS、LTC的设置类似，只需修改ccy参数。

第2步：设置交割合约

三个交割合约（BTC-USD-210319、210326、210625）共用同一标的指数（BTC-USD），只需设置一次：

{
  "instId": "BTC-USD-210319",
  "lever": "3",
  "mgnMode": "cross"
}

第3步：设置永续合约

虽然标的指数相同，但永续和交割的杠杆设置是独立的：

{
  "instId": "BTC-USD-SWAP",
  "lever": "3",
  "mgnMode": "cross"
}

总结：发送6个API请求（4个币种 + 1个交割 + 1个永续），完成8个产品的杠杆配置。

总结

使用V5 API设置子账户和配置交易参数的关键步骤：

1. 创建子账户API Key：通过母账户API管理
2. 配置账户模式：在网页端选择现货/合约/跨币种保证金
3. 设置持仓模式：单向或双向，需先清空持仓
4. 配置杠杆倍数：按币种或产品分别设置
5. 选择保证金模式：下单时指定全仓或逐仓

下一部分会讲解V5 API的实战技巧：WebSocket下单、订单推送、持仓对账等。

常见问题

Q: V3 API还能用吗？ A: 可以，但建议尽快迁移到V5。V3将逐步停止维护。

Q: V5 API有速率限制吗？ A: 有。普通用户20次/2秒，VIP用户更高。详见API文档。

Q: 如何测试API？ A: 使用模拟盘环境，避免真实资金风险。

Q: API密钥泄露怎么办？ A: 立即删除旧密钥，创建新密钥，并绑定IP白名单。

由于欧易会持续改进统一账户交易系统，上述内容可能随之变动。请查阅V5 API文档获取最新规范。

点击查看《使用欧易V5 API的技巧和诀窍（2）》

相关阅读：

• OKX API完全指南
• WebSocket API实战教程
• API安全最佳实践
• 量化交易入门
• 高频交易策略开发
• API速率限制优化

免责声明

本文章可能包含不适用于您所在地区的产品相关内容。本文仅致力于提供一般性信息，不对其中的任何事实错误或遗漏负责任。本文仅代表作者个人观点，不代表欧易的观点。 本文无意提供以下任何建议，包括但不限于：(i) 投资建议或投资推荐；(ii) 购买、出售或持有数字资产的要约或招揽；或 (iii) 财务、会计、法律或税务建议。 持有的数字资产 (包括稳定币) 涉及高风险，可能会大幅波动，甚至变得毫无价值。您应根据自己的财务状况仔细考虑交易或持有数字资产是否适合您。有关您具体情况的问题，请咨询您的法律/税务/投资专业人士。本文中出现的信息 (包括市场数据和统计信息，如果有) 仅供一般参考之用。尽管我们在准备这些数据和图表时已采取了所有合理的谨慎措施，但对于此处表达的任何事实错误或遗漏，我们不承担任何责任。 © 2025 OKX。本文可以全文复制或分发，也可以使用本文 100 字或更少的摘录，前提是此类使用是非商业性的。整篇文章的任何复制或分发亦必须突出说明：“本文版权所有 © 2025 OKX，经许可使用。”允许的摘录必须引用文章名称并包含出处，例如“文章名称，[作者姓名 (如适用)]，© 2025 OKX”。部分内容可能由人工智能（AI）工具生成或辅助生成。不允许对本文进行衍生作品或其他用途。

展开

相关推荐

比特币下跌也能盈利？如何进行合约交易

随着以比特币为代表的数字货币市场规模的不断扩大，在现货交易之外逐步催生出形式多样的衍生品交易，来作为一种对冲风险的工具，其中最受关注的莫过于合约交易。 合约交易是什么？ 合约是数字货币衍生品市场中最常见的交易合约形式。数字资产合约交易是指买卖双方约定在未来某个时间，按指定价格，对某种资产进行交易。

2026年1月16日

比复制策略更简单？在OKX一键跟单最强策略交易员，让交易员帮你赚钱

不管是在传统金融领域，还是在加密货币市场，策略交易都是交易体系中非常重要且关键的一种方式，当面临复杂的交易环境和极端的交易行情时，即使拥有扎实的理论技术知识和丰富的交易经历经验，也很容易错失交易时机，或者受到情绪影响做出错误判断和操作。而策略交易正是能够解决这些问题的有效工具。 交易工具有了，怎么使

2025年11月21日

五、策略交易系列课程——屯币宝

前言： 我们经常会有这样的猜想： 牛市中有很多大涨的数字资产，如果能够连续捕捉涨幅较大的币种，比如每月捕捉一个翻倍的数字资产，一年后你的资产就会变成2的12次方，即4096倍，这是非常惊人的，当然这也是几乎不可能完成的事情，因为我们很难连续抓住大涨的币种。 这也是很多用户会遇到的问题： 牛市中，虽然

2025年11月3日

哪些国家/地区不支持注册使用欧易

欧易目前不支持对下列地区的客户提供服务：部分美国领土，如 纽约、德克萨斯州、 波多黎各、美属萨摩亚、关岛、北马里亚纳群岛邦、美属维尔京群岛 (圣克罗伊岛，圣约翰岛和圣托马斯岛)，古巴、伊朗、朝鲜、克里米亚、马来西亚、叙利亚、孟加拉国和玻利维亚。 有关详情，请参阅 欧易服务条款 。

2024年4月25日

快速了解欧易常用产品及功能

欧易（www.okx.com）是全球著名的数字资产服务平台之一，主要面向全球用户提供 比特币 、以太坊等数字资产的币币和衍生品交易服务，同时也和用户一同探索DeFi，DApp, NFT和GameFi的世界。 在欧易，您可以享受 币币 、合约等流畅的交易体验，第一时间关注热门领域/概念的代币信息，还有

2024年4月25日

零基础学K线 | 5 K线组合应用的重要性

涨跌有趋势，读懂价格语言； 买卖有信号，告别感觉交易。 一、看涨K线组合发关键位置 在本章的前两期我们讲解了K线看涨组合和看跌组合的应用，但这些组合不是在任何位置出现都有效。本节我们就来讲解组合出现位置的重要性。 看涨组合在哪些位置可以更好的发挥作用呢？ 第一种情况：在一段明显的上涨走势中，临近的前

2024年4月25日