关于 hyperliquid
Hyperliquid via Dwellir 面向使用 Dwellir 托管 Hyperliquid 基础设施的开发者,介绍 EVM RPC、市场数据 API、gRPC 数据流、订单簿流及 CLI 端点和密钥管理。
主要功能
- 01访问 HyperEVM JSON-RPC
- 02通过 Info API 查询市场与用户数据
- 03获取 Hypercore gRPC 数据流
- 04实时订单簿 WebSocket
- 05发现端点并管理 API 密钥
- 06专用节点选项
适用场景
- 01查询 HyperEVM 状态和合约
- 02构建市场数据应用
- 03订阅订单簿与 Hypercore 数据流
- 04在终端查找端点并管理密钥
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ dwellir-public/ hyperliquid-skills --skill hyperliquid安装后在 Claude Code 中输入/hyperliquid确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSEREADME.mdreferences/historical-data.mdhyperevm-json-rpc.mdgrpc-gateway.mdinfo-api.mddwellir-cli.mdnative-api.mdorderbook-websocket.mdskills/hyperliquid-data/LICENSE详细介绍
通过 Dwellir 使用 Hyperliquid
Hyperliquid 是专为交易优化的 L1 区块链。Dwellir 运行自己的 Hyperliquid 节点,并提供超越标准 RPC 的基础设施:用于 Hypercore 数据的自定义 gRPC 网关、实时订单簿服务,以及可过滤的 Info API 代理,并在新加坡和东京部署了边缘服务器。
Hyperliquid 的工作原理
Hyperliquid 分为两层:
HyperCore 是原生交易层,提供完全在链上的永续期货和现货订单簿。每笔订单、撤单、交易和强制平仓都在一个区块内结算。通过 HyperBFT 共识,每秒可处理约 200,000 笔订单,并实现亚秒级最终性。
HyperEVM 是与 HyperCore 并行运行的通用 EVM 智能合约层。开发者可以部署与 HyperCore 流动性交互的 Solidity 合约。链 ID:999。原生 Gas 代币:HYPE。
主要特性:
- 所有订单簿都完全在链上(无链下撮合)
- 亚秒级出块时间,且一个区块即可实现最终性
- 永续合约支持最高 40 倍杠杆(BTC);大多数资产支持 3 至 10 倍杠杆
- 支持原生现货交易和 HIP-3 DEX 部署
Dwellir 提供的服务
Dwellir 运行完整的 Hyperliquid 基础设施:官方 HL 节点,以及由 Dwellir 和社区构建、用于提供特定数据通道的自定义软件。
有关当前定价、功能和服务详情,请参阅 Dwellir Hyperliquid 文档 和 定价。
| 端点 | 提供内容 | 协议 | 参考文档 |
|---|---|---|---|
| HyperEVM JSON-RPC | EVM 状态、智能合约、区块 | HTTPS + WSS | hyperevm-json-rpc.md |
| Info API 代理 | 市场数据、用户状态、元数据 | HTTPS (POST) | info-api.md |
| L1 gRPC 网关 | Hypercore 原始数据流 + 类型化市场数据流(V3;兼容 V2) | gRPC + x-api-key | grpc-gateway.md |
| 订单簿 WebSocket | 实时 L2/L4/BBO 订单簿数据 + 交易 | 仅 WSS | orderbook-websocket.md |
| 专用节点 | 完整技术栈,不限吞吐量 | 全部 | 见下文 |
Dwellir CLI
Dwellir CLI(dwellir)可通过终端访问端点发现、API 密钥管理、用量监控和文档。它有助于快速查找 Hyperliquid 端点 URL、无需离开终端即可阅读文档,以及在 CI 流水线中管理密钥。请参阅 dwellir-cli.md。
# Install
curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh
# Find all Hyperliquid endpoints
dwellir endpoints search hyperliquid
# Read Hyperliquid docs as markdown
dwellir docs search hyperliquid
dwellir docs get hyperliquid/info-endpoint
# Manage API keys and check usage
dwellir keys list
dwellir usage summary
Dwellir 不代理的内容
Exchange API:下单、撤单、转账和其他写入操作需要 EIP-712 签名,并直接发送到 api.hyperliquid.xyz/exchange。请参阅 native-api.md。
原生 WebSocket:Hyperliquid 的订阅 WebSocket(wss://api.hyperliquid.xyz/ws)用于用户事件、交易和蜡烛图数据,与 Dwellir 的订单簿 WebSocket 是独立的。请参阅 native-api.md。
读写架构
┌─────────────────────────────────────────────────────────┐
│ Your Application │
├──────────────────┬──────────────────────────────────────┤
│ READ (Dwellir) │ WRITE (Hyperliquid native) │
│ │ │
│ EVM state ──────┤ Place orders ─── api.hyperliquid.xyz │
│ Info queries ───┤ Cancel orders /exchange │
│ gRPC streams ───┤ Transfers (requires sig) │
│ Order book ─────┤ Set leverage │
└──────────────────┴──────────────────────────────────────┘
何时使用哪种参考资料
| 你想要…… | 使用此参考资料 |
|---|---|
| 在 HyperEVM 上部署或与 Solidity 合约交互 | hyperevm-json-rpc.md |
| 查询 EVM 状态(余额、日志、区块) | hyperevm-json-rpc.md |
| 获取市场数据(价格、订单簿、K 线、资金费率) | info-api.md |
| 查询用户持仓、订单、成交记录或余额 | info-api.md |
| 获取永续合约/现货元数据(交易标的集合、杠杆、资产) | info-api.md |
| 通过实时数据流获取深度订单簿更新 | orderbook-websocket.md |
| 构建做市或套利系统 | orderbook-websocket.md |
| 获取 L1 区块数据或成交执行数据流 | grpc-gateway.md |
| 基于 Hypercore 构建索引器或数据管道 | grpc-gateway.md |
| 下单、取消订单或修改订单 | native-api.md |
| 订阅用户事件、交易或 K 线更新 | native-api.md |
| 访问历史交易/成交数据 | historical-data.md |
| 通过终端查找端点 URL、管理 API 密钥或阅读文档 | dwellir-cli.md |
专用节点
在单租户基础设施上运行完整的 Hyperliquid 技术栈。无共享速率限制,吞吐量不设上限。提供东京(主网)和测试网配置。
专用节点包含运行在隔离基础设施上的所有 Dwellir 服务(EVM JSON-RPC、Info API、gRPC Gateway、Orderbook Server)。
如需了解当前价格和配置选项,请参阅 Dwellir Hyperliquid Pricing。
请通过 dashboard.dwellir.com 联系销售团队或订阅。
最佳实践
-
读取使用 Dwellir,写入使用 Hyperliquid 原生接口。 Dwellir 提供数据基础设施;下单需要签名,并通过
api.hyperliquid.xyz/exchange完成。 -
对延迟敏感的数据流使用 gRPC 网关。 gRPC 端点从磁盘读取数据,延迟低于通过 HTTP 轮询 Info API。
-
使用 Dwellir 的 Orderbook WebSocket 获取订单簿数据。 它针对订单簿数据传输进行了优化,并在新加坡和东京设有边缘服务器。
-
批量查询 Info API。 使用
metaAndAssetCtxs等组合端点(通过公共 API 获取),而不是逐个查询资产。请查看 Info API 文档,了解 Dwellir 代理和公共端点分别支持哪些类型。 -
缓存元数据。
meta、spotMeta和perpDexs半静态不变,可缓存 1-5 分钟。 -
使用 Info API 的
l2Book获取快照,使用 Orderbook WS 获取数据流。 Info API 提供特定时点的快照;Orderbook WebSocket 提供持续更新。
文档链接
- Dwellir Hyperliquid 文档:dwellir.com/docs/hyperliquid
- Dwellir L1 gRPC Gateway:请联系 [email protected] 获取源码访问权限
- Dwellir Orderbook Server:请联系 [email protected] 获取源码访问权限
- Dwellir REST Server:请联系 [email protected] 获取源码访问权限
- Hyperliquid API 文档:hyperliquid.gitbook.io
- Hyperliquid Python SDK:github.com/hyperliquid-dex/hyperliquid-python-sdk
- Dwellir 控制面板:dashboard.dwellir.com
- Dwellir 支持:[email protected]