本文介绍了API交易的基本概念和欧易最新的API接口升级，包括API密钥、API文档、功能接口、API v3和v5的功能对比，以及API v5的整体功能升级，旨在帮助交易者了解并使用欧易的API交易功能，提高交易效率。
API交易概览及欧易最新API接口
在做交易的时候，交易者通常需通过交易平台找到要交易的资产，通过观察报价、图表和订单簿，然后在该界面下达市价、限价或止损订单。
但对于高频交易而言，这不是最有效的方式。目前高阶交易者的需求可以通过自动或算法交易系统得到满足，这些系统允许交易者通过编程实现他们的交易策略，以确保在合适的时间和价格执行，避免了持续性的人工操作。
API（Application Programming Interface，应用程序编程接口）是此类自动交易系统的核心，其本质是一组允许软件平台实时共享数据和有效通信的编程代码。
算法交易机构和专业交易者是API交易的主要用户。当然通过第三方平台，散户交易者也可以间接使用API管理交易。
为了满足用户的需求，欧易提供了先进的API功能并持续进行升级。我们将在本文中简要介绍欧易的API交易以及API v5的新升级。
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在以下方面进行了关键改进：
- 提高资金利用效率
- 交易产品共用统一API
- REST和WebSocket API都支持订单操作
- 用于报错的统一JSON格式
- 更灵活的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的更多技术细节，👉 查看实时API文档。
常见问题
API交易适合哪些用户？
API交易主要面向算法交易机构和专业交易者，通过编程实现自动化交易策略。散户交易者也可通过第三方平台间接使用API管理交易，提升交易效率。
API v5相比v3有哪些主要优势？
API v5在资金利用率、多产品支持、订单操作灵活性等方面有显著提升。统一账户资金管理、多产品共用API、支持REST和WebSocket订单操作等，使交易更高效便捷。
如何开始使用欧易API v5？
首先需要创建API密钥，包括公钥和私钥。然后参考官方API文档，根据需求选择REST或WebSocket接口进行集成。建议从模拟交易开始测试，确保策略稳定后再投入实盘。
WebSocket订阅在API v5中有何改进？
API v5支持同时订阅多个币对或合约数据，并新增账户和持仓频道的定时推送功能。这有助于用户更高效地管理风险和实时监控市场变化。
API v5是否支持子账户管理？
是的，API v5新增子账户模块，支持母账户管理子账户的API密钥、查询余额以及直接进行资金划转，便于机构用户更灵活地管理多个账户。
API v5在错误处理方面有何优化？
API v5采用统一的JSON格式返回错误信息和正常结果，简化了数据处理流程。而API v3缺乏统一格式，需要额外兼容处理，增加了开发复杂度。