此网页仅供信息参考之用。部分服务和功能可能在您所在的司法辖区不可用。

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

欧易

发布于 2022年12月06日

更新于 2024年4月25日

阅读时长 6 分钟

引言

欧易在推出统一账户交易系统的同时，亦把 API 由 V3 升级到了 V5，带来了更多和更完善的功能。本文旨在讲解 V5 API 相对于 V3 API 有什么改动，亦会提出在交易前设置账户时，有哪些技巧和诀窍。

V5 API 的改动

产品共用统一 API

V5 API 其中一个改动就是所有产品共用统一 API，无论是下单还是查看持仓信息，都不再像 V3 API 那样以产品划分。

举个例子，我们下单的时候，只需要连接到以下 URL，并在请求 body 中列明产品类型：

POST /api/v5/trade/order

任何产品类型，在同一个 API 都会使用同样的请求和返回结果格式。换言之，您无需再特别为每个产品创建相应 API 的模型。

更短的命名规则

V5 API 的字段改为驼峰式大小写，并会用上缩写，更能节省带宽和内存开销。

示例：

字段	V5 API	V3 API
Currency (币种)	ccy	currency
Instrument ID (产品 ID)	instId	instrument_id
Underlying (合约标的指数)	uly	underlying
Unrealized PnL (未实现盈亏)	upl	unrealized_pnl

标准 WebSocket 数据压缩

V5 API 使用标准的 WebSocket 压缩扩展“Per-Message Deflate”，收到 WebSocket 信息后无需再以 V3 API 的方式手动解压缩数据。

要使用 WebSocket 数据压缩，请检查客户端是否已启用相关的扩展，启用后发送的请求头应包含“permessage-deflate”。

公共和私有 WebSocket

WebSocket 频道现分为两类：公共频道（如行情、K 线）和私有频道（如账户、持仓）。

两类频道各需要连接的 URL 并不相同。连接公共频道的 WebSocket 时不用传送登陆请求，否则订阅会失败。

使用 WebSocket 下单

除 REST 之外，V5 API 新增了 WebSocket 下单/改单/撤单。详情请查阅 API 文档或本文章的第 2 部分。

登陆

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

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

创建子账户的 API Key

在使用母账户（即主账户）时，现在我们可以透过 V5 API 进行子账户 API Key 的 CRUD 操作（创建、查询、更新、删除）。

创建	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

我们强烈建议您为 API Key 绑定 IP 地址，加强账户安全。

配置账户

完成创建子账户和 API Key 后，还有一步就是配置每一个账户。

账户配置

我们可以通过以下的 REST API 查看当前账户/子账户的配置：

GET /api/v5/account/config

API 会返回 (1) 账户模式、(2) 持仓模式、(3) 自动借币设置、(4) 期权希腊值 PA/BS 的配置。

账户模式

欧易统一账户交易系统提供多个账户模式：(i) 现货模式、(ii)现货和合约模式、(iii) 跨币种保证金模式。

由于更改账户模式需要用户的操作，仅限于在网页上更改。

持仓模式

欧易统一账户交易系统新增了单向持仓模式（买卖模式），亦保留了原有的双向持仓模式（开平仓模式）：

单向持仓模式	只可持有多头或空头仓位。交易所会根据您所指定的持仓数量自动开/平仓
双向持仓模式	可同时持有多头仓位和空头仓位

我们可以通过以下的 REST API 设置持仓模式（设置前需平掉所有仓位）：

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

自动借币

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

期权希腊值 PA/BS

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

POST /api/v5/account/set-greeks

全仓/逐仓保证金模式

欧易统一账户交易系统的全仓/逐仓设置更为弹性，我们可以同时以全仓和逐仓交易同一产品。

因此，V5 API 并没有设置合约标的指数保证金模式的 API。取而代之，我们需要在下单时指定该订单的保证金模式（交易模式）。详情请查阅 API 文档或本文章的第 2 部分。

杠杆倍数

获取杠杆倍数

我们可以通过以下的 REST API 获取杠杆倍数：

GET /api/v5/account/leverage-info

目前杠杆倍数没有全局设置，同一产品可以有几种杠杆倍数的设置场景。

币币杠杆：

其他产品类型：

设置杠杆倍数

在获取杠杆倍数之后，可根据您的需要设置杠杆倍数：

POST /api/v5/account/set-leverage

我们可以运用上述两个 API 编写程序，在交易前预先设置每个产品的杠杆倍数。

示例：

假设我们有以下的设置和需求：

账户模式：跨币种保证金
持仓模式：单向持仓
需要设置杠杆倍数为 3.0 的产品：
- BTC-USDT、EOS-USDT、LTC-BTC、LTC-USDT
- BTC-USD-210319、BTC-USD-210326、BTC-USD-210625
- BTC-USD-SWAP
以上产品只使用全仓保证金模式

币币/币币杠杆的设置层面为币种，我们可以截取币种去逐一设置，即 BTC、USDT、EOS 和 LTC。

设置 BTC 币种杠杆倍数为 3.0 的请求 body 示例（适用于卖出 BTC-USDT 和买入 LTC-BTC）：

设置 USDT、EOS 和 LTC 的请求 body 也很类似，不在此一一列举。

下一步就是设置 BTC-USD-210319、BTC-USD-210326 和 BTC-USD-210625 的杠杆倍数。因为这三个产品都有共同的标的指数（即 BTC-USD），我们只需在这三个产品中选其一设置杠杆倍数。

最后，我们需要设置 BTC-USD-SWAP 的杠杆倍数。虽然标的指数和以上的交割一样为 BTC-USD，但交割和永续的杠杆倍数设置是分开独立的，我们仍需要发送以下请求 body 去设置：

在发送了以上共 6 个 API REST 请求后，这 8 个产品杠杆倍数的设置便完成了。

总结

运用以上的技巧和诀窍，我们应该能够使用新的 API 设置子账户，亦能设置各种账户配置如持仓模式和杠杆倍数等，配合您的交易风格。

在下一部分，我们会讲解一些在使用 V5 API 交易时的技巧和诀窍，如使用 WebSocket 下单和订单成交推送与持仓的对账。

由于欧易会持续不断地改进统一账户交易系统，上文提到的这些想法均会随之发生变动。请查阅 V5 API 文档以得知最新的规范：做市商申请

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

免责声明

本文章可能包含不适用于您所在地区的产品相关内容。本文仅致力于提供一般性信息，不对其中的任何事实错误或遗漏负责任。本文仅代表作者个人观点，不代表欧易的观点。本文无意提供以下任何建议，包括但不限于：(i) 投资建议或投资推荐；(ii) 购买、出售或持有数字资产的要约或招揽；或 (iii) 财务、会计、法律或税务建议。持有的数字资产 (包括稳定币和 NFTs) 涉及高风险，可能会大幅波动，甚至变得毫无价值。您应根据自己的财务状况仔细考虑交易或持有数字资产是否适合您。有关您具体情况的问题，请咨询您的法律/税务/投资专业人士。本文中出现的信息 (包括市场数据和统计信息，如果有) 仅供一般参考之用。尽管我们在准备这些数据和图表时已采取了所有合理的谨慎措施，但对于此处表达的任何事实错误或遗漏，我们不承担任何责任。欧易 Web3 功能，包括欧易 Web3 钱包和欧易 NFT 市场都受单独的服务条款约束。

© 2025 OKX。本文可以全文复制或分发，也可以使用本文 100 字或更少的摘录，前提是此类使用是非商业性的。整篇文章的任何复制或分发亦必须突出说明：“本文版权所有 © 2025 OKX，经许可使用。”允许的摘录必须引用文章名称并包含出处，例如“文章名称，[作者姓名 (如适用)]，© 2025 OKX”。不允许对本文进行衍生作品或其他用途。

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

引言