API交易概述及OKX最新API接口
通常，交易需要使用交易所平台筛选股票或比特币等数字资产。交易者找到要交易的资产，观察报价、图表和订单簿，然后通过界面下达市价单、限价单或止损单。
这本身是对过去股票交易系统的重大进步，但仍然不是最高效的流程，尤其是对于高频交易而言。如今，高级交易员的需求由自动交易系统或算法交易系统来满足，这些系统允许交易员编写策略，并使其执行并适应市场情况，而无需持续的人工输入。
API，即应用程序编程接口，是此类自动交易系统的核心，本质上是一组允许软件平台共享数据并实时有效通信的编程代码。
算法交易公司和专业交易员是 API 交易的主要用户，而零售交易员也可以利用 API 连接其投资组合管理应用程序或通过第三方软件进行交易。
为了满足用户的需求，OKX 提供了先进的 API 功能，并持续对其进行升级。本文将简要介绍 OKX 的 API 交易，并概述新的 OKX API v5 升级。
API交易基础知识
进行 API 交易时，有三个必不可少的工具：
- API 密钥
- API 文档
- 连接接口
API 密钥是用于验证访问交易所 API 的交易者和开发者身份的唯一标识符。简单来说，API 密钥由公钥和密钥组成，其工作原理类似于用户名和密码的组合。
API 文档包含有关如何使用和集成 API 的技术信息——本质上可作为开发人员和交易者的参考手册。
API 主要有两种类型——REST 和 WebSocket。REST 代表表述性状态转移 (Representational State Transfer)，是最常见的 Web 服务，支持 HTTP 下的多种格式，例如 JSON 和 XML。WebSocket 是一种新的 HTML5 协议，可实现客户端和服务器之间的高效数据传输。这对于打算编写脚本、机器人或其他软件并将其与交易所连接的开发人员尤其有用。
OKX API交易
OKX 提供三类 API 交易：账户、交易和行情。在账户和交易模块中，用户可以下单、查询订单状态和账户信息。此外，OKX 用户还可以通过公开的行情数据 API 获取交易对的历史价格数据。
OKX 在 API v3 中为其用户支持 REST 和 WebSocket API，交易者可以使用 API 进行五种交易产品，包括现货、保证金、期货、永续掉期和期权。
虽然零售和机构交易者都可以使用 API v3，但为了继续改善用户体验，OKX 一直致力于升级其 API 系统，以提高资金效率、错误报告机制等。
OKX API v5
为了给用户提供更流畅的交易体验，OKX 推出了全新的 API v5，目前所有统一账户用户均可使用。v5 是 v3 的重大升级（v4 版本被跳过，因为“4”在东亚一些地区被认为是不吉利的数字），v5 在以下方面进行了关键改进：
- 提高资本配置效率
- 同时支持多种交易产品
- 通过 REST 和 WebSocket API 进行订单操作
- 统一的错误报告 JSON 格式
- 更灵活的WebSocket订阅和定时推送
在本文中，我们比较了 API v3 和 v5 的功能以及新版本中 API 交易的改进。
v5 中的功能升级
API v5 的功能升级适用于所有 API 用户。这些升级涉及账户资金使用、多业务线支持等。
账户资金使用情况
在 API v3 中，每条业务线都有一个对应的账户。这意味着用户需要将资金从一个交易产品转移到另一个交易产品。频繁的资金转移非常耗时，降低了用户的资金效率。此外，不同交易产品账户之间的资金转移限制为每秒一次。
使用 API v5 时，交易者可以提高资金效率。与 OKX 的统一账户类似，使用 API v5 的交易者可以将资金集中到一个账户中。此外，v5 中不同仓位的盈亏也会根据用户的账户模式进行合并，从而提高资金效率。
跨产品的统一 API
与 API v3 不同，API v5 中的端点（例如用于下单和检索仓位的端点）在所有产品之间是统一的。同一 API 中的所有工具类型都使用相同的请求和响应数据模型，这意味着我们不再需要为每个产品 API 单独建模。
订单操作
订单操作包括下单、修改订单和取消订单。v3 版本中只有 REST API 支持订单操作，而新的 API v5 版本同时支持 REST API 和 WebSocket API 两种方式的订单操作。
基于场景的升级
场景化升级是指针对特定功能或格式的升级，包括订单模式升级、时间功能、REST响应功能的格式升级等。
下单方式
API v3 仅支持开仓和平仓——如果用户在同一衍生合约中同时持有多头和空头头寸，则这些头寸将被分开查看，并且不能相互抵消。
与统一账户功能结合，API v5 为用户新增了净额模式。这意味着同一交易对或工具中的多头和空头仓位可以相互抵消，用户可以查看净额仓位。
WebSocket订阅函数
订阅功能允许用户获取数据。与 API v3 相比，API v5 允许用户同时订阅多个交易对。
此外，API v5 定期推送账户和仓位通道，更加方便用户进行风险管理。
REST响应的格式
响应是指用户尝试检索信息时返回的数据。API v3 中有两种 REST 响应格式——正常返回格式和错误报告格式。这两种格式在同一接口中不兼容，给用户带来不便。相反，API v5 遵循统一的 JSON 格式来处理 REST 响应。
私人清算令
在 API v3 中，用户无法直接查看私人强平订单的状态。他们需要通过 REST API 连接端点来查看。
API v5 的订单通道支持私有强平订单，用户可以直接查看订单状态，“类别”字段表示该订单是部分强平还是全强平。
已开合约数量
API v3 中的用户想要查看合约开通数量时，需要向 WebSocket 账户通道发送请求才能查看。
在 API v5 中读取已开合约数量更加直接，用户可以通过 REST API 中的“获取最大合约数量”接口获取此类信息。
子账户模块
API v5 提供此模块来支持：
- 子账户的 API 密钥管理，包括创建、删除和重置功能。
- 查询子账户的账户余额。
- 两个子账户之间直接进行资金转账。
时间格式
API v3 采用 ISO8601 时间格式，参考 UTC 时区。然而，此时间格式可能并非在所有编程语言中都兼容。因此，需要额外的时区转换功能。
API v5 采用了更通用的时间格式：Unix 纪元，不考虑时区。API v5 库中也提供了相关资源，方便开发者轻松进行时间格式转换。
现货交易市价单
使用 API v5 进行现货交易时，用户可以根据自身需求选择市价单的成交单位。相比之下，API v3 用户只能使用计价货币作为买入市价单的成交单位，使用基础货币作为卖出市价单的成交单位。
API v5 的发布
自 3 月 31 日起，所有统一账户用户均可使用 API v5。由于 API v3 将在 v5 全面推出后不久停用，我们鼓励用户升级 API 至 v5，以获得更强大的功能和更流畅的交易体验。
有关新 API v5 的更多技术细节，请参阅此处的指南。