能,通过那个公开 API
能:Hyperliquid 把它整套交易接口作为一个公开的 HTTP API 发布出来,和网页端用的是同一套。读取不需要密钥,写入需要一个签名动作,而一个账户可以批准一个 API 钱包来签署它们,而不是用自己的密钥。
| 它用来做什么 | 在哪里 |
|---|---|
| 读取:中间价、L2 订单簿、K 线、资金费率历史、一个账户的状态。不需要密钥,不需要签名。 | POST https://api.hyperliquid.xyz/info |
写入:order、cancel、modify、updateLeverage、approveAgent、withdraw3 以及其余那些,每一个都要签名。 | POST https://api.hyperliquid.xyz/exchange |
实时流(allMids、l2Book、trades、candle、userFills),也是走 HTTP 发送之外的另一条路。 | wss://api.hyperliquid.xyz/ws |
| 测试网上同样的三条路。 | api.hyperliquid-testnet.xyz |
有三个地址要紧,就在下面,而这个页面上的每一个数字都是 2026 年 10 月 5 日文档里的。
文档列出的那些 SDK
你不必手工拼出签名动作。文档点名了一个官方 Python SDK,hyperliquid-dex/hyperliquid-python-sdk,一个社区 Rust SDK,两个社区 TypeScript SDK(nktkas/hyperliquid 和 nomeida/hyperliquid),以及 CCXT。
签名这一块值得借来用,而不是重写。一个动作要按一个精确的形状序列化并签名,而一个字段错了的形状会被拒绝:那笔订单根本到不了订单簿。
API 钱包和 nonce
一个主账户可以批准一些 API 钱包,代表这个主账户或者它的任何一个子账户来签名。它们只会签名:要查一个账户的数据,你必须传入那个账户的真实地址,用智能体钱包的地址会拿到一个空结果。
nonce 比看上去更严。Hyperliquid 为每个地址保存最高的 100 个 nonce,而一个新动作需要的 nonce 要大于这组里最小的那个、以前没用过,并且落在(T 减 2 天,T 加 1 天)这个窗口里,其中 T 是那个区块的 unix 毫秒时间戳。
一个 API 钱包会在这些情况下被清掉:注册了一个新的未命名钱包、一个新的命名钱包占用了一个已有的名字、它过期了,或者注册它的那个账户不再有资金。文档警告说,一个被注销的代理,它的 nonce 状态可能被清掉,所以以前签过的动作可能被重放:请生成一个新的智能体钱包,不要去救活一个旧的。
那些速率限制,按文档所写
- 按 IP。REST 请求共用一个每分钟 1200 的加权总额。一个 exchange 动作的权重是
1 + floor(batch_length / 40),所以批量几乎是免费的;多数 info 请求权重是 20,少数几个是 2,而userRole是 60。 - 按地址。累计每成交 1 USDC 换 1 个请求,起步先给 10000 个请求的额度,用完之后每 10 秒一个。撤单有一份更宽的额度。
- Websocket。最多 10 个连接、每分钟 30 个新连接、1000 个订阅、每分钟发送 2000 条消息,以及 100 条同时在途的 post 消息。
- 挂单数。默认上限 1000,每 500 万 USDC 的成交量再加一个,总数封顶 5000。
按地址那条限制会让一个新程序吃惊:它的额度是靠交易挣来的,而一个盲目重试的循环把它花在了什么也没有上。
一个脚本、一个机器人、一个助手
| 它是什么 | 谁来决定 | 它要你给什么 |
|---|---|---|
| 一个脚本 | 你决定的,在你把它写出来的时候。它跑一串步骤,什么都不挑。 | 在运行之前读一遍。它的额度就是你敲进去的那些行。 |
| 一个机器人 | 你写下的一条规则,只要它的条件成立就动手,没人看着。 | 规则之外的额度,以及一条命令就能把它停下的办法。 |
| 一个助手(一个 AI 智能体) | 模型提议;代码拿数字来核查这个提议。 | 它放宽不了的边界,以及一个提不了币的密钥。 |
这个 API 分不出三者里是谁在调用,而且对三者一视同仁。它们的区别在于决定是在哪里做出来的,以及决定错了之后会怎样:一个脚本错了就错一次,一个机器人会错一整夜。
Locker Protocol Agentic 是第三类:给人或者给 AI 智能体用的 lpa,一个把同样的命令做成工具的 MCP 服务器,一份在任何订单之前被核查两次的本地策略,以及一份由你自己的钱包签署的授权书。它不承诺任何结果。