欧易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在以下方面进行了关键改进:
- 提高资金利用效率
- 交易产品共用统一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的更多技术细节,请参阅我们的指南。