Hyperliquid API 入门：2026 年新手指南

• hyperliquid api

• hyperliquid api guide

• Hyperliquid API 教程

• 链上交易 API

locale: zh-CN

Hyperliquid API 入门：2026 年新手完全指南

如果你曾想过用程序化方式参与链上永续合约交易，Hyperliquid 的 API 是目前链上 DEX 中最接近中心化交易所体验的选择之一。它提供了完整的行情查询、账户管理和下单接口，配合 WebSocket 实时推送，足以支撑从简单量化策略到复杂做市程序的各类需求。本文面向初次接触 Hyperliquid API 的开发者，系统讲解接口体系、认证方式、入门示例和常见坑点。

Hyperliquid API 能做什么

根据 Hyperliquid 官方文档，API 主要分为三大类：

信息查询端点（Info Endpoints）：获取市场数据，包括当前订单簿快照、近期成交记录、资金费率历史、账户持仓和历史订单。这类接口无需签名，公开可访问。

交易端点（Exchange Endpoints）：执行下单、撤单、修改仓位杠杆、调整保证金等写操作。这类接口需要对请求体进行钱包签名，安全性要求高。

WebSocket 实时推送：订阅订单簿变动、成交流、账户事件等实时数据流，适合需要低延迟响应的策略。

基础 URL 与接口结构

Hyperliquid 的 REST API 基础 URL 为 https://api.hyperliquid.xyz。所有请求均使用 POST 方法，请求体为 JSON 格式。Info 类接口发往 /info，Exchange 类接口发往 /exchange。具体字段定义请以 官方文档 为准，以下示例仅作入门演示，实际使用前务必核对最新文档。

认证方式

Hyperliquid 的交易接口采用 EIP-712 结构化数据签名，而非传统的 API Key + Secret 方式。这意味着：

你需要一个以太坊兼容的钱包地址作为身份标识

每笔交易请求需要用对应私钥签名

签名直接证明了请求来自该地址的授权持有人，无需中间层

这种设计本质上更安全——没有可被盗取的 API Key，签名权限完全由私钥控制。然而，这也意味着私钥管理的重要性被大幅提升。一旦私钥泄露，攻击者可以构造合法签名直接操控你的账户。

这正是 OneKey 钱包 发挥作用的场景。OneKey 硬件钱包将私钥隔离在安全芯片中，签名操作在设备内部完成，私钥永远不会暴露给主机或网络。对于需要频繁调用交易 API 的量化交易者，可以使用 OneKey 生成专用的子账户密钥，在不影响主账户安全的前提下授权 API 操作。

信息查询示例：Python + curl

以下是一个查询当前所有可交易资产元数据的简单示例：

使用 curl：

curl -X POST https://api.hyperliquid.xyz/info \

-H "Content-Type: application/json" \

-d '{"type": "meta"}'

使用 Python（requests 库）：

import requests

import json

url = "https://api.hyperliquid.xyz/info"

payload = {"type": "meta"}

headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

data = response.json()

print(json.dumps(data, indent=2))

返回结果包含所有可交易合约的基本信息，包括资产名称、最大杠杆、最小下单量等字段。这类查询完全公开，无需任何认证，是入门 Hyperliquid API 的最佳起点。

查询账户持仓

查询特定地址的持仓状态同样属于 Info 类接口，需要提供钱包地址：

payload = {

"type": "clearinghouseState",

"user": "0xYOUR_WALLET_ADDRESS"

}

response = requests.post(url, json=payload, headers=headers)

返回数据包含保证金余额、各合约持仓量、未实现盈亏等信息。注意：这是公开可查的链上数据，任何人都可以查询任意地址的持仓状态。

WebSocket 实时订阅

WebSocket 端点为 wss://api.hyperliquid.xyz/ws。连接建立后，发送订阅消息即可开始接收实时推送：

import asyncio

import websockets

import json

async def subscribe_orderbook():

uri = "wss://api.hyperliquid.xyz/ws"

async with websockets.connect(uri) as ws:

sub_msg = {

"method": "subscribe",

"subscription": {

"type": "l2Book",

"coin": "BTC"

}

}

await ws.send(json.dumps(sub_msg))

while True:

msg = await ws.recv()

data = json.loads(msg)

print(data)

asyncio.run(subscribe_orderbook())

可订阅的数据类型包括：L2 订单簿（l2Book）、近期成交（trades）、账户事件（userEvents，需认证地址）、全局资金费率等。

常见坑点

请求格式错误是最常见的问题来源。Hyperliquid API 对 JSON 字段的类型和命名非常严格，一个字段类型错误（例如把整数写成字符串）就会导致请求被拒绝，错误信息有时不够直观，需要对照文档仔细排查。

签名构造是另一个难点。EIP-712 签名涉及类型定义、域分隔符等细节，手动实现容易出错。建议优先使用社区维护的 Hyperliquid SDK（Python/JavaScript 均有），减少重复造轮子的风险，同时降低签名错误的概率。

时间戳同步也需要注意。交易请求通常需要附带当前时间戳，且有效期窗口有限。如果本地时钟与网络时间偏差过大，请求可能因过期而被拒绝。

网络异常处理是生产环境必须考虑的问题。WebSocket 连接可能因网络波动中断，REST 请求可能遇到临时性错误，策略代码需要具备自动重连和请求重试逻辑。

速率限制概述

Hyperliquid 对不同类型的接口设有不同的速率限制，具体数值以 官方文档 的最新版本为准。一般原则是：Info 类查询接口的限制相对宽松，而 Exchange 类交易接口的限制更严格，频繁下单撤单的策略需要特别注意。遇到 429 错误时，应立即暂停请求并实施指数退避策略，而非简单重试。

开发环境建议

在正式部署策略之前，强烈建议：

首先在小仓位下进行实盘测试，而非直接上线大资金策略。Hyperliquid 目前据报道没有独立的测试网络供永续合约交易测试，因此首次实测应严格控制仓位规模。

将签名密钥与主账户资产隔离。可以创建一个专用的子账户或独立地址用于 API 交易，将风险敞口控制在可接受范围内。配合 OneKey 钱包 的多账户管理功能，可以方便地实现这种隔离。OneKey 下载 支持桌面端和移动端，方便在不同设备上管理不同用途的账户。

代码开源参考：OneKey GitHub 展示了如何安全地在应用层集成钱包签名，对开发者有一定参考价值。

FAQ

Q1：Hyperliquid API 需要注册账户吗？

答：不需要传统意义上的注册。你只需要一个以太坊兼容的钱包地址，该地址在 Hyperliquid 上完成首次操作（如充值）后即可使用 API。整个过程无需 KYC 或邮箱注册。

Q2：用 Python 调用 Hyperliquid API 有没有现成的 SDK？

答：社区和官方均有 Python SDK 可用，建议在 Hyperliquid 官方 GitHub 页面查找最新维护的版本。使用 SDK 可以大幅简化签名构造和请求格式处理。

Q3：WebSocket 连接断开后如何自动重连？

答：建议在 WebSocket 客户端代码中实现心跳检测（定期发送 ping）和自动重连逻辑。连接断开后，应在短暂等待（如 1-5 秒）后尝试重新建立连接并重新订阅所需频道。实际等待时间可以采用指数退避策略，避免在服务端故障期间造成请求风暴。

Q4：API 交易的资金安全如何保障？

答：API 交易的安全性本质上取决于私钥的保管方式。使用 OneKey 硬件钱包 进行签名可以确保私钥永远不暴露给联网设备，是目前已知的最高安全级别。此外，建议为 API 专用账户设置合理的仓位上限，并定期检查未完成订单和持仓状态。

Q5：Hyperliquid API 是否支持条件单和止损单？

答：Hyperliquid 支持触发单（Trigger Order）类型，包括止损和止盈逻辑。具体参数和触发条件请参考 官方文档 中关于 Order Type 的详细说明。实现复杂的条件逻辑时，也可以在策略层面通过监控持仓状态自行实现。

总结

Hyperliquid API 为开发者提供了一套功能完整、文档相对清晰的链上 DEX 接口体系。Info 类接口适合构建行情监控和数据分析工具；Exchange 类接口配合 WebSocket 可以支撑从简单跟单到复杂做市的各类自动化策略。

在安全层面，EIP-712 签名机制的设计要求开发者必须认真对待私钥管理。将 OneKey 钱包 作为签名后端，不仅能在日常手动操作中保护资产安全，也能在 API 交易场景中提供硬件级别的密钥隔离保障。如果你正准备开始 Hyperliquid 的 API 开发之旅，这是一个不应忽视的安全基础设施选择。访问 OneKey 官网 了解更多，或直接前往 下载页 开始体验。

---免责声明---

本文内容仅供技术参考，不构成投资建议。API 交易涉及自动化风险，策略错误可能导致非预期的大额亏损。永续合约交易具有高杠杆特性，风险极高。请在充分理解相关技术和市场风险后，谨慎评估并决定是否参与。过往的策略表现不代表未来收益。