Hyperliquid Foundation WebSocket 的变更:这对您意味着什么
Hyperliquid 基金会将在下一次网络升级后对其公共WebSocket数据流进行调整。以下内容将说明这对自动化交易者意味着什么,以及如何使用Quicknode 将对延迟敏感的工作负载迁移至gRPC 流式传输服务。

2026年6月9日,Hyperliquid 的核心成员equipe 宣布,在下次网络升级后,若干公开的 WebSocket API 数据源将降低数据推送频率。2026年6月11日,equipe 根据用户反馈调整了该计划的实施安排: webData2 在接下来的一次网络升级中,将保持当前5秒的推送间隔,标准 l2Book 将每2秒调整为20级,随后调整为5秒,并新增一个 fastAssetCtxs WebSocket 数据流将保留各交易对每 5 秒的标价差异。
受影响的数据源仍包括订单簿深度、中间价、资产背景、所有去中心化交易所(DEX)的资产背景,以及 webData2,预计仍将迁移至 webData3.
对于仪表盘、投资组合监控和面向用户的界面,新的时间间隔或许可以接受。但对于自动化交易系统而言,这会改变数据模型。那些基于公共 WebSocket 快照进行报价、下单、取消或路由订单的策略,现在需要采用不同的数据层。
Hyperliquid的equipe 直截了当地阐述了该工作负载的预期发展路径:
“自动化交易者应运行一个非验证节点,以获得更多层级或实时更新streams 。”
本文将说明有哪些变化、这些变化对机器人为何重要,以及如何将对延迟敏感的Hyperliquid 工作负载迁移到使用 Quicknode。
公共 API 数据源 | 升级后的新行为 | 对运营的影响 |
|---|---|---|
webData2 | 在接下来的一个网络升级中,仍将保持当前的5秒推送间隔。仍需迁移至webData3。 | 仍在读取 webData2 的应用程序还有一些时间,但不应将该数据源视为永久性的。 |
l2Book | 如果设置了 fast: true,则每 0.5 秒更新 5 个等级;如果未设置 fast: true,则每 2 秒更新 20 个等级。预计后续升级将把每 20 个等级的更新间隔调整为每 5 秒一次。 | 交易逻辑必须在浅层、更快的订单簿顶部数据与更深层、更慢的快照之间做出选择。 |
allMids | 每5秒一次。 | 在两次调整之间,基于中位价的逻辑可能会偏离当前的市场状态。 |
spotAssetCtxs / allDexsAssetCtxs | 每15秒一次。新的fastAssetCtxs WebSocket数据流仍以最初的5秒间隔提供标记价格差异。 | 需要5秒标记价格差异的接口可以使用fastAssetCtxs;交易系统仍应评估资产上下文是否应纳入决策路径。 |
该 l2Book 对于自动化策略而言,变化是最重要的。如果没有 fast: true, 在下次升级后,公共 API 每 2 秒返回 20 个等级,预计后续将调整为每 5 秒返回一次。随着 fast: true,它每0.5秒返回5个价位。这两种选项均无法为依赖深度、队列行为或快速点差变化的策略提供完整的实时行情。
这并非通常意义上的系统中断或破坏性变更。这是共享公共基础设施与自动化交易系统所需的数据配置文件之间的一条界限。
对于机器人来说,过时的书并不是一种不便,而是被视为错误的输入。
做市商需要实时深度数据,以便围绕实时库存和点差进行报价。成交机器人需要实时中间价和订单簿压力来确定订单规模。清算、套利和基差策略则需要上一次快照与当前区块之间的差异尽可能小。
当某只股票以2秒或5秒的频率更新时,该策略不仅会滞后于该时间间隔,而且是基于不同的市场状态进行操作。这会影响:
报价的发布与取消时间
点差、滑点和逆向选择的计算
仓位规模与风险核查
触发订单的清算和资金监控机制
假设数据源与生产环境类似的回测
对于用户界面、被动监控以及非关键性显示数据而言,公共 API 仍然有其适用性。而依赖当前深度数据的交易逻辑,则需要专门为此设计的数据源,无论是 WebSocket 订阅还是gRPC 数据流。
Hyperliquid的建议是运行一个非验证节点,以获取更多层级的数据或实时更新streams 。这使自动化交易者能够直接访问所需的数据配置文件,但同时也带来了基础设施方面的工作:节点运维、升级、监控、断连处理、容量规划以及客户端集成。
Quicknode 这是一个区块链开发平台,通过单一的endpoint 提供覆盖 HyperCore 和 HyperEVM 的托管型Hyperliquid 基础设施。每个Hyperliquid endpoint 均支持 WebSocket 和gRPC 。对于受此次公共 API 变更影响的团队而言,最相关的功能是HyperCoregRPC 流式传输。这并非因为 WebSocket 本身不合适,而是因为我们发现 WebSocket 在大规模场景下存在以下脆弱性:重连风暴、基于数据包的流不稳定性,以及多市场订阅中的有效载荷开销。
Quicknode's Hyperliquid 文档 列出了gRPC 对完整HyperCore数据集streams 的支持,包括双向流传输、市场数据亚毫秒级延迟,以及可将带宽降低约70%的原生zstd压缩。访问 /hypercore/hypercore JSON-RPC, /hypercore/hypercore WebSocket 以及 HyperCoregRPC 需要“Build”方案或更高版本。
请先阅读《Quicknode 》Hyperliquid 文档以及《Hyperliquid 》gRPC 流式传输 API 参考文档。
关键区别不仅仅在于拥有一个私有的endpoint 。更在于能够访问适合自动化交易工作负载的 HyperCore 数据集。
QuicknodeHyperliquid 的数据集涵盖已执行交易、订单生命周期事件、订单簿更新、TWAP执行数据、账户和余额事件、HyperCore到HyperEVM的写入操作、原始区块、L2订单簿快照、L4订单簿快照及差异数据,以及testnet 内存池交易。
这一点很重要,因为公共 WebSocket 数据流的合适替代方案取决于该策略的具体功能。做市商所需的数据与清算监控工具不同,而仪表盘所需的数据又与订单路由器不同。
数据集 | API 可用性 | 适用场景 |
|---|---|---|
行业 | gRPC + JSON-RPC/WSS | 已成交交易、价格追踪和交易分析。 |
订单 | gRPC + JSON-RPC/WSS | 订单生命周期监控、成交、撤单及执行状态。 |
BOOK_UPDATES | gRPC + JSON-RPC/WSS | 用于深度和流动性监控的前瞻性订单簿变化。 |
TWAP | gRPC + JSON-RPC/WSS | TWAP 执行进度及算法执行分析。 |
活动 | gRPC + JSON-RPC/WSS | 余额、转账、存款、取款、金库操作、资金支付以及优先级Gas拍卖费用。 |
WRITER_ACTIONS | gRPC + JSON-RPC/WSS | HyperCore 到 HyperEVM 的资产转移和桥接数据。 |
BLOCKS | gRPC 仅 | 用于归档系统和链上分析的HyperCore区块链原始数据。 |
StreamL2Book | gRPC 仅 | 聚合的价格水平深度,每个区块都会生成完整的快照。 |
StreamL4Book | gRPC 仅 | 单个静止订单、初始快照以及按区块划分的差异。 |
StreamBboBook | gRPC 仅 | 订单簿顶部的最佳买价/卖价,仅在BBO发生变化时发出。其更新频率比0.5秒的l2Book快速轮询更为及时。 |
StreamL2BookDiff | gRPC 仅 | L2价格水平的增量变化,附带每枚代币的序列号,用于高效维护本地订单簿。 |
StreamL4BookUpdates | gRPC 仅 | 按订单类型编写的添加/更新/删除差异记录,用于按订单跟踪和微观结构分析。 |
StreamTpslUpdates | gRPC 仅 | 基于未平仓订单快照的触发(TP/SL)订单添加/删除更新,用于止损监控和警报。 |
MEMPOOL_TXS | gRPC 仅限testnet 网站 | testnet 上在区块确认前的待处理交易。 |
StreamL2Book 每块都会提供一份完整的聚合 L2 订单簿快照。每条消息都包含按价格级别划分的当前买单和卖单,并列出了每个级别的总成交量和订单数量。
使用 StreamL2Book 当您的策略需要按价格水平获取当前深度,但无需通过增量价差构建局部订单簿时。该数据流支持可配置的深度,并提供 n_levels 最多 100,此外还可选配价格分桶功能以实现更广泛的汇总。
与一家公共机构相比 l2Book 该数据流每0.5秒推送5个价位,或每2秒推送20个价位,随后将调整为每5秒推送一次;这种方式更适合做市、点差监控、深度感知成交以及基于订单簿的警报。
StreamL4Book 以单笔订单为粒度提供订单簿数据。订阅时,它会发送当前挂单(买单和卖单)的完整快照。此后,它会发送按区块划分的增量数据。
使用 StreamL4Book 当仅靠汇总价格水平还不够时。例如:队列分析、订单级流动性研究、市场微观结构研究,以及需要追踪单个挂单而非仅追踪价格水平总和的系统。
StreamL2Book 和 StreamL4Book 仅支持gRPC 。无法通过 WebSocket 或 JSON-RPC 访问。
交易需求 | 升级后的公共 WebSocket | Quicknode 路径 |
|---|---|---|
新的 L2 深度 | 每0.5秒提升5级,或每2秒提升20级,之后调整为每5秒提升一次 | StreamL2Book 每个区块的完整聚合快照 |
书首更新 | 最佳近似方案是使用 l2Book,每 0.5 秒进行一次快速轮询 | StreamBboBook 变更时触发最佳买入价/卖出价 |
20多个关卡 | 无法从更新的公共推送模型中获取 | StreamL2Book,深度可配置,最高可达100层 |
个人订单簿 | 无法通过公共 WebSocket 快照获取 | StreamL4Book 的初始完整快照及按区块的差异 |
订单生命周期监控 | 公共数据源的更新频率可能与执行需求不匹配 | 通过gRPC 提交的订单,包括成交、取消和状态变更 |
低带宽多市场流媒体 | JSON WebSocket 有效载荷 | gRPC 采用原生 zstd 压缩 |
历史补填 | 访问模式不正确 | HyperCore JSON-RPC,包括 hl_getBatchBlocks 函数,每个请求最多可处理 200 个区块 |
您无需一次性迁移所有Hyperliquid 集成。不妨先将决策输入与显示输入分开处理。
对每项订阅进行分类。
触发订单、取消、仓位调整或风险限额的数据源应优先迁移。而用于支持仪表盘、用户可见图表或被动监控的数据源,通常可以继续使用 WebSocket。
将 public 替换为 l2Book 用于交易决策。
使用 StreamL2Book 如果您的策略需要价格层深度、订单簿顶部数据的新鲜度或点差计算,请使用 StreamL4Book 如果需要单个订单的状态或队列级别的详细信息。
围绕流模型设计重新连接行为。
使用 StreamL2Book,每条消息都是该区块的完整 L2 快照,因此您的消费者可以在每次更新时用新的快照替换本地价格水平状态。通过 StreamL4Book,从快照初始化,应用差异,并在重新连接时从新的快照重置。
将执行、分析和告警分别置于不同的路径中。
一种常见的生产环境配置模式是:使用gRPC 获取策略的实时市场数据,使用Hyperliquid 获取交易 API 或SDK 处理本地签署的订单,使用 JSON-RPC 进行批量和历史数据读取,使用Streams 或Webhooks 处理异步事件管道,以及使用 SQL Explorer 进行研究或调查。
在过渡期间同时运行这两个数据源。
在网络升级之前,请将您现有的公共 WebSocket 消费者与新的gRPC 消费者并行运行。对比订单年龄、观察到的价差、更新间隔、成交质量以及任何策略特有的风险指标。这将为您提供一个具体的切换方案,而非在最后一刻仓促地切换至endpoint 。
Quicknode 维护了一个公开的 HyperCoregRPC 示例代码库,供基于Hyperliquid gRPC streams 进行开发的开发者使用。该代码库包含 JavaScript、Python、Go 和 Rust 示例,其中包含共享的 proto 定义、zstd 解压缩支持、服务器端过滤示例,以及mainnet 和testnet endpoint 两种格式。
gRPC 它应该是查找对延迟敏感的HyperCore市场数据的首选之地,但并不需要承载所有工作负载。
WebSocket 已在所有Hyperliquid endpoint 上提供。它仍然为浏览器仪表盘、投资组合视图、监控界面以及任何更新模式与策略相匹配的交易工作负载提供支持。
JSON-RPC支持数据补全、批量区块读取、投资组合状态、清算所状态以及与 HyperEVM 合约的交互。
SQL Explorer能够查询超过 5000 亿行已建立索引的Hyperliquid 数据,并将查询作为可编程的 REST 端点对外提供。
Quicknode其Hyperliquid 链页面还列出了99.99%的正常运行时间SLA、每月超过60亿次的Hyperliquid API请求,以及超过5000亿行可查询数据。当工作负载不是演示,而是一个全天候运行的交易系统时,这些数字就显得尤为重要。
请访问quicknode.com/signup 注册一个Quicknode 账户。
在Quicknode 仪表盘中创建一个Hyperliquid endpoint 。一个endpoint 可提供对 HyperCore 和 HyperEVM 的统一管理访问权限。
查看可用的Hyperliquid 数据集,并将每项策略输入映射到其所需的流上。
请参考Hyperliquid gRPC 中的流媒体 API 文档,将您的客户端连接到该服务。
选择与您的策略相符的流: StreamL2Book 对于汇总价格水平的深度, StreamL4Book 用于单笔订单级别的状态,或交易、订单、事件及订单簿更新的标准数据集。
克隆 HyperCore 的gRPC 示例代码库,以在 JavaScript、Python、Go 或 Rust 中测试订阅功能。
请查阅《Hyperliquid 》指南库和示例应用库中的示例代码。
Hyperliquid该平台的公共API更新表明,该网络正将共享端点转向更轻量、覆盖范围更广的访问模式。自动化交易者需要一条不同的路径:实时深度、更多层级、实时streams ,以及专为始终在线系统构建的基础设施。
Quicknode 提供了该设置的托管路径,而无需您自己运行 Node.js 基础设施。
从 Quicknode Hyperliquid 文档开始。
Quicknode 成立于 2017 年,为开发者和企业提供机构级区块链基础设施。凭借 99.99% 的运行时间以及对 77 条以上区块链的支持,团队能够毫无妥协地构建和扩展链上应用程序。
将最新的工程见解、产品更新和 Web3 资讯直接发送至您的收件箱。
📚 新书:《在……上构建金融软件》Solana免费电子书,内含10套完整的交易策略,涵盖期权到永续合约。
获取一份