欧易OKEX V3API与V5API简单对比

作为欧易okex API忠实粉丝，从V1API至V5API都有接入，因为V1已经下线很久就不多做说明了，接下来就简单聊聊V3API与V5API的简单区别吧。

V3API文档：https://www.okex.com/docs/zh/

V5API文档：https://www.okex.com/docs-v5/zh/

其实大家都知道V5与V3最主要的区别就是V5支持统一交易账户了，那什么是统一交易账户呢？

统一交易账户（Unified Account）是欧易OKEx面向广大用户推出的新一代交易系统，支持在一个账户中使用多币种资产同时交易现货和各类衍生品，这将会为用户的交易提供极大的便利，不再需要在多个账户之间进行资金划转；且不同业务线的盈亏可以互相抵消、有效提升了用户的资金利用率。统一交易账户提供了三种新的账户模式：简单交易模式（Simple）、单币种保证金模式（Single-currency margin）和跨币种保证金模式（Multi-currency margin），可满足用户不同的交易习惯和诉求。以下为三种账户模式的详细介绍：

账户模式	交易权限	用户使用条件
简单交易模式	账户可交易品种： · 币币 · 期权（仅支持买方交易） *该模式下不支持保证金交易	用户首次使用默认激活该模式
单币种保证金模式	账户可交易品种： · 币币 · 杠杆 · 永续 · 交割 · 期权 账户可用保证金模式： · 逐仓 · 单币种全仓 *单币种全仓模式下，所有结算货币相同的交易品种之间会共用保证金，交易盈亏可相互抵消	完成答题并激活该模式
跨币种保证金模式	账户可交易品种： · 币币 · 杠杆 · 永续 · 交割 · 期权 账户可用保证金模式： · 逐仓 · 跨币种全仓 *跨币种全仓模式下，所有交易品种之间会共用保证金，交易盈亏可相互抵消	统一交易账户权益折合>=10,000美金，完成答题并激活该模式

对于API来说，单从文档上来看，V3和V5最大的区别就是接口更少了，几乎缩减一半，V3各业务线接口各自独立，V5是提供统一的一套API接口支持所有交易业务线，这个大大节省了大家的接入时间。

资金方面：上线实时结算功能，跨币种保证金模式，不需要考虑资金划转，只要账户里有币就可以开仓任一合约，极大地提升资金利用率；

下单方式：增加Websocket交易模式；可以通过Websocket方式进行下单撤单等操作；

增加查询某一合约ID的产品状态（交易中、暂停中、预上线）

Websocket账户/持仓频道支持首次订阅按订阅维度推送初始数据，且无特定触发条件时，会定时推送数据

下方为V3与V5某些上面的上一些对比，整体上看V5优势较大。

条目	v3	v5
账户资金	资金使用效率低：每一个业务线都有对应的账户，不同账户间资金不能共享，需要频繁划转资金来提高利用率，同时资金划转有1s一次的频率限制	资金使用效率高：5大业务线共享一个账户，不需要资金划转，不同业务线盈亏互相抵消，提高资金使用效率
业务线	调用复杂。相同功能接口，不同业务线路径不同，需要分别接入	调用简单。同一功能，只需要接入一个接口，即可支持5大业务线
订单操作 （下单、撤单、改单）	订单操作方式单一，仅支持rest	订单操作方式更多样化，支持rest和websocket
下单模式	下单模式单一：仅支持开平仓模式，不支持买卖模式，同一合约，不同方向的持仓只能分开，不支持合并。	下单模式更多样化：同时支持开平仓模式和买卖模式，在买卖模式下，同一合约，不同方向的仓位会相互抵消，从而达到不同方向仓位合并的效果。
ws订阅功能	单个频道订阅功能单一：订阅同一频道的多个币对，只能一个个地拼接相关的频道，进行批量订阅	单个频道订阅功能更丰富：通过单个频道可以方便地订阅多个币对或者合约，比如订单、持仓等频道传“ANY”。
Rest响应格式	格式不统一：有2种格式，正常返回格式和报错格式，在处理返回数据时需要根据接口进行兼容处理	格式统一：接口报错和正常返回都遵循统一的json格式，code值为0时，代表接口请求成功 { "code": "0", "msg": "", "data": [] }
私有强平单	order频道不推送私有强平单：因此要用rest接口做补偿，增加了复杂度	Order频道会推送私有强平单，且通过category字段可以判断出减仓还是爆仓。
合约可开张数	获取时有条件限制：只有Websocket的account频道会返回“合约可开张数”，获取时需要account频道有推送，才能获取	获取时无条件限制：Rest的“获取最大可交易数量”接口可以直接获取，无条件限制。
时间格式	不通用：接口返回的是ISO8601格式（UTC时区），某些编程语言无转换时间格式的系统函数，所以转换时需自定义函数进行处理	格式通用：接口返回的是Unix Epoch时间格式，不受时区困扰，编程语言有相关的库函数，格式转换方便。
产品信息	操作繁琐：需获取全部产品信息，再从中筛选自己想要信息	操作简单：可直接指定币对获取，更加精准、简便

小结：本文主要讲了一些V3API与V5API接口层面以及产品层面简单对比，相信对大家会有所帮助。整理不易，若有需求，点赞支持并留言我会继续分享给大家，感谢！