欧易API交易—API v5功能升级及优势

API交易概览及欧易最新API接口

在做交易的时候，交易者通常需通过交易平台找到要交易的资产，通过观察报价、图表和订单簿，然后在该界面下达市价、限价或止损订单。

但对于高频交易而言，这不是最有效的方式。目前高阶交易者的需求可以通过自动或算法交易系统得到满足，这些系统允许交易者通过编程实现他们的交易策略，以确保在合适的时间和价格执行，避免了持续性的人工操作。

API（Application Programming Interface，应用程序编程接口）是此类自动交易系统的核心，其本质是一组允许软件平台实时共享数据和有效通信的编程代码。

算法交易机构和专业交易者是API交易的主要用户。当然通过第三方平台，散户交易者也可以间接使用API管理交易。

为了满足用户的需求，欧易提供了先进的API功能并持续进行升级。我们将在本文中简要介绍欧易的API交易以及API v5的新升级。

API交易基础

在API交易方面，有三个基本工具：

API密钥

API文档

功能接口

API密钥是对访问交易所API的交易者和开发人员进行身份验证的唯一标识符，简单来说，API密钥由公钥和私钥组成，其工作方式与用户名和密码的组合非常相似。

API文档包含有关如何使用和集成API的技术信息——本质是作为开发人员和交易者的参考手册。

有两种主要类型的API——REST和WebSocket。REST（Representational State Transfer，表现层状态转换）是最常见的Web服务，支持HTTP下的各种格式，例如JSON和XML。WebSocket是一种新的HTML5协议，可实现客户端和服务器之间的高效数据传输，对于打算通过编程和连接脚本、机器人或其他软件接入交易所的开发人员特别有用。

欧易的API交易

欧易提供三类API交易：账户、交易和市场数据。在账户和交易模块中，用户可以下单、查询订单状态和账户信息。此外，欧易用户可以通过公开的市场数据API访问交易产品的历史价格数据。

关于API v3，欧易同时支持REST和WebSocket API，交易者可以使用该API访问五大交易产品，包括币币、杠杆、交割、永续和期权。

虽然API v3可供散户和机构交易者使用，但出于进一步改善用户体验的目的，欧易升级了API系统，以提高资金利用效率、更新报错机制等。

API v5

为了给用户提供更丝滑、便捷的交易体验，欧易新推出了API v5，目前可供所有统一账户的用户使用。作为v3的重大升级，v5在以下方面进行了关键改进：

1. 提高资金利用效率
2. 交易产品共用统一API
3. REST和WebSocket API都支持订单操作
4. 用于报错的统一JSON格式
5. 更灵活的WebSocket订阅及定时推送

在本文中，我们比较了API v3和v5的功能，以及新版本对API交易的改进。

API v5的整体功能升级

API v5中的功能升级适用于所有API用户，包括账户资金利用率、对多业务线的支持以及订单操作等。

账户资金利用率

在API v3中，每个业务线都有一个对应的账号，这意味着不同账户间的资金不能共享，频繁的划转资金既耗时，又降低了资金的利用率。此外，不同交易产品账户间的资金划转被限制在每秒1次。

使用API v5时，交易者可以获得更高的资金利用率。对应于统一账户，API v5各业务线共用一个账户资金，同时不同业务线的盈亏可以互相抵消，进一步提高了资金的利用效率。

交易产品共用统一API

API v3只允许用户访问一种交易产品的接口，相比之下，API v5允许用户最多访问五个交易产品的接口，所有产品共用统一API，无论是下单还是查看持仓信息。任何产品类型，在同一个API都会使用同样的请求和返回结果格式。换言之，您无需再特别为每个产品创建相应的API的模型。

订单操作

API v5中的订单操作（下单、撤单和改单）的方式更加多样化，支持REST和WebSocket接口，而API v3中订单操作只支持REST接口。

API v5使用场景的升级

使用场景升级针对某个具体的功能或返回格式，包括下单模式、时间格式以及REST返回格式等。

下单模式

API v3只支持交割、永续的开平仓模式，用户在一个合约上的多头持仓和空头持仓是独立的，不能轧差。而API v5同时支持用户选择买卖模式，意味着在一个合约上的持仓可以按净头寸计算，多头持仓和空头持仓互相轧差。

WebSocket订阅功能

用户通过订阅WebSocket获取所需的数据。相比于API v3，API v5支持用户同时订阅多个币对或合约的数据。另外API v5中，账户和持仓频道还有定时推送功能，有助于用户的风险管理。

子账户模块

API v5中新提供了子账户模块，支持以下功能：

管理子账户的API Key，包括创建、删除以及重置操作；

母账户查询子账户的余额；

在子账户之间直接进行资金划转。

REST返回格式

API v5中，REST接口报错和正常返回都遵循统一的JSON格式,而在API v3中并没有统一的返回格式，用户在处理返回数据时需要进行额外的兼容处理。

私有强平单数据

API v5中的订单频道会推送私有强平单，用户可以通过category字段来决定增加或是减少仓位，而在API v3中频道不推送私有强平单，导致要用REST接口做补偿查询。

合约可开张数

API v5中，用户通过REST的“获取最大可买卖/开仓数量”接口，可以直接获取某个合约的可开张数。而在API v3中，只能通过订阅WebSocket的账户频道，得到这个信息。

币币市价委托

API v5中，币币的市价委托时，可以根据用户的实际需求自行选择数量单位。而在API v3中，买入市价委托时只能以计价货币为单位，卖出市价委托时只能以交易货币为单位。

时间格式

API v5中，返回的所有时间戳都是Unix Epoch时间格式，不受时区困扰，编程语言有相关的库函数，格式转换方便。而在API v3中，接口返回的是ISO8601格式（UTC时区），某些编程语言没有转换时间格式的系统函数，需要用户自定义函数进行处理。

有关API v5的更多技术细节，请参阅我们的指南。