Hyperliquid API：2026 年机器人与量化交易者指南

Hyperliquid API 是 Hyperliquid 永续合约交易所的公开编程接口。由于 Hyperliquid 是一个完全链上的 DEX，凡是你能通过交易界面做到的事 — 读取价格、下单、管理持仓 — 都可以通过签名并发送请求在代码中完成。这让机器人、量化策略和自定义看板成为头等的使用场景，而不是一种变通手段（Hyperliquid Docs — API (Info, Exchange & WebSocket)）。

API 的请求采用纯粹的 基于 HTTP 的 JSON，并配有一个单独的 WebSocket 用于推送，因此可从任何语言访问。对于 Python 开发者，还有一个封装了整套接口的 官方 SDK。本指南将逐一讲解三个接口面、通过代理钱包实现的鉴权机制、SDK 和速率限制，以及如何上手。

API 被组织为三个接口面，各司其职（Hyperliquid Docs — API (Info, Exchange & WebSocket)）：

• Info 端点（读取）。 返回市场元数据、订单簿、K 线、资金费率、你的未平仓持仓、余额和历史成交。大多数 Info 请求无需签名 — 它们是机器人在做任何决策之前观察世界的方式。
• Exchange 端点（交易）。 发生状态变更之处：下单、改单和撤单，设置杠杆和保证金模式，以及在你自己的账户内部划转资金。每一个 Exchange 请求都必须由你的钱包或已授权的代理钱包 用密码学方式签名。
• WebSocket（实时）。 订阅实时价格、订单簿、成交和账户更新数据流，让机器人能即时反应，而不必轮询。对于任何对延迟敏感的场景，WebSocket 都是你应当围绕其构建的接口面。

一个典型的循环是这样的：从 Info（或一个 WebSocket 订阅）读取状态，应用你的策略逻辑，再通过 Exchange 端点执行操作。这个“读取-决策-执行”的循环是几乎每一个 Hyperliquid 交易机器人的骨架。

让 Hyperliquid 上的 API 交易真正安全的那一环，是 代理钱包（也称 API 钱包）。你不必把主私钥交给机器人，而是授权一个独立密钥，它能 下单和撤单，却无法提取或转移你的资金 （Hyperliquid Docs — API (Info, Exchange & WebSocket)）。

• 它保持非托管。 你的 USDC 和持仓始终留在你自己的 Hyperliquid 账户中。代理密钥对它们签署交易操作；它从不持有它们。
• 泄露的影响被控制在最小范围。 一个被泄露的代理密钥能让攻击者交易你的账户，却无法掏空它 — 其波及范围远小于一个带提现权限、被泄露的中心化交易所 API 密钥。
• 可持有的数量是有限制的。 一个账户能批准的代理钱包数量有限，且授权可能过期 — 请在文档中确认当前的具体数值（Hyperliquid Docs — Rate limits and user limits）。

最快的上手方式是 Hyperliquid 的 官方开源 Python SDK，它封装了 Info、Exchange 和 WebSocket 三个接口面，处理请求签名，并附带常见任务（如下单或订阅数据流）的示例脚本（Hyperliquid — official Python SDK (GitHub)）。它只是一层便利封装 — 其底层就是同一套你也能从 JavaScript、Rust 或 Go 调用的 JSON/HTTP API。

生产级机器人必须遵守 速率限制。Hyperliquid 既制定了按 IP 的请求限制，也制定了 随交易活动伸缩的按地址限制，外加让较重请求“消耗”更多的按权重计费（Hyperliquid Docs — Rate limits and user limits）。其实际含义是：

• 优先使用 WebSocket 而非轮询。 订阅数据流远比在循环里反复敲打 Info 端点划算。
• 批处理并退避。 在 API 允许之处合并请求，并加入指数退避，以免一次突发就被限流。
• 核实确切数值。 限制会随时间变化，因此请在构建时从官方速率限制页面读取数据，而不要相信二手博客（Hyperliquid Docs — Rate limits and user limits）。

从零到一个上线、自托管机器人的一条切实可行的路径：

1. 为 Hyperliquid 账户充值。 你需要在交易所上、自己钱包里有链上 USDC — 这就是 API 将读取并交易的账户。
2. 批准一个代理钱包。 生成并授权一个 API/代理密钥，让你的代码能签署 Exchange 请求，却始终不持有提现权限。
3. 用 Info / WebSocket 读取。 先从拉取市场数据和你的持仓开始 — 没有资金风险 — 直到数据流稳定可靠为止。
4. 通过 Exchange 下测试单。 使用小额仓位（或只挂单 / 远离中间价的限价单）来确认签名、成交和撤单都如预期般工作。
5. 在扩大规模前加入风控。 仓位上限、最大杠杆、急停开关和回撤限制从第一天起就该写进代码，而不是等到第一个糟糕的交易日之后。

从那之后，难的是策略 — 而非管道铺设。关于策略类别（做市、套利、网格、趋势、均值回归），参阅 加密算法交易；关于把一个想法变成值得运行之物的“从研究到上线”工作流，参阅 加密量化交易。想从头到尾了解机器人全景，参阅 加密交易机器人。

Hyperliquid API 为构建者提供了一个完整、非托管的交易接口：用于读取的 Info 端点、用于交易的 Exchange 端点、用于实时数据的 WebSocket、能交易却永不提现的 代理钱包、一个官方 Python SDK，以及 有据可查的速率限制。正是这套组合，让自托管机器人和量化策略在 Hyperliquid 上切实可行。

仅为教育内容 — 不构成投资建议。自动化交易存在风险，机器人可能亏损；过往或回测表现并不预示未来结果。API 端点、速率限制、代理钱包限制和 SDK 要求都会变化 — 在构建或交易之前，请以官方 Hyperliquid 文档核实所有内容。Facts verified 2026-06-30.