我应该使用哪个 API?REST 与 WebSocket

上次更新时间: 2025年8月8日

我们的 API 提供了一种以编程方式与我们的平台交互的方式,但这两个平台都提供两种不同的接口:在现货交易中,有REST和 WebSocket(v1v2),在期货交易中,也提供了REST 和 WebSocket API。有时,为特定任务选择最合适的接口可能是一个艰难的决定。

REST 和 WebSocket 之间的差异

在现货交易中,REST 和 WebSocket 都提供完全相同的市场数据(订单簿、交易历史等)和完全相同的账户数据(账户余额、订单/交易状态等),但它们的方式却大相径庭。

REST 提供一种调用/响应(提问/回答)类型的接口,并提供当前数据的快照,而 WebSocket 提供一种实时流式传输类型的接口,并提供实时更新。

一个类比是照片和视频之间的区别,照片在请求时提供主题的快照,但没有进一步的更新,而视频提供主题的实时视图和实时流式更新。

实施简易性

虽然 REST 和 WebSocket 都不难实现,但普遍认为 REST 的复杂性较低,这可以减少开发时间,并更快地解决任何后续问题。

REST 基于标准 HTTPS 请求,这些请求包含在所有现代编程语言的标准库中(如果不是,也可以轻松从头开始编写),而 WebSocket 基于 HTTPS 的 WSS 升级,通常需要额外的第三方库(例如我们推荐的 Python WebSocket 库)。

我们的 API 支持页面提供了适用于 REST 和 WebSocket 的现成示例代码,因此可以根据更关键的标准而不是实现难度来选择接口。

我应该使用哪个 API 接口?(REST 或 WebSocket)

根据手头的任务,仅使用 REST、仅使用 WebSocket,或者更可能结合使用 REST 和 WebSocket,将是最佳选择。

对于只需要偶尔更新市场数据的任务,REST 将是首选。例如,一个每天只要求每 24 小时获取一次市场数据的日均成本机器人,将不需要实时流式市场数据,因此 REST 市场数据端点将非常适用。

对于需要最新市场数据的任务,WebSocket 将是首选。例如,一个套利机器人将需要来自多个市场的实时市场数据,以便利用瞬时价格差异,因此 WebSocket 市场数据源将是理想选择。

在大多数情况下(例如大多数交易机器人),结合使用 REST 和 WebSocket 将实现最有效的实施。例如,一个移动应用程序可能需要实时市场数据来显示图表,而只需要偶尔的账户数据(例如在进行交易或资金交易时),因此将 WebSocket 市场数据源与 REST 订单/交易/资金状态端点结合使用将是最有效的组合。

在哪里可以找到最佳 API 实施建议

我们的API 支持团队很乐意与您讨论您的 API 实施方案,并根据您的预期使用场景,就如何最佳地使用我们的 API 提供建议。

需要更多帮助吗?