Hyperliquid 怎么运作

从到账的那一块钱,到成交的那一笔订单,再到钱出去。签的是什么、链核查两次的是什么,以及一个 API 钱包可以做和不可以做什么。

最后更新:2026年10月5日

一连串步骤

从另一条链上的一块钱,到 Hyperliquid 上的一个仓位,中间隔着六步。

  1. USDC 到达 HyperCore。它在 Hyperliquid L1 上原生铸造,而 Circle 的跨链转账协议把它从 Arbitrum 搬过来。
  2. 它入账到你的地址。充值先入账到那个地址在永续合约清算所里的全仓保证金余额。
  3. 你签一笔订单。一个市场、一个方向、一个数量、一个价格和一个杠杆,由账户的密钥签署,或者由它批准过的 API 钱包签署。
  4. 订单进入那个资产的订单簿,价格是最小变动价位的整数倍,并按价格优先、时间优先撮合。
  5. 成交改变你在清算所里的仓位,而只要仓位还开着,资金费率就每小时结算一次。
  6. 提币是一次签名,只在 Hyperliquid 上签:验证者签好,再把请求发给桥合约。

把美元弄进去

USDC 在 Hyperliquid L1 上原生铸造,而从 Arbitrum 过来的路线是 Circle 自己的协议,Circle 有文档说明。更早的 Arbitrum 桥已经弃用:文档说它现在持有的不到 HyperCore 上 USDC 总量的 10 %。

那座旧桥的机制还是值得知道,因为多数指南讲的还是它。发到它上面的 USDC 会在不到一分钟内入账给发出的那个地址,最小充值额是 5 USDC,而文档直说:比这更小的金额不会入账,而且永远丢失。

到账的钱落在全仓保证金余额里,它撑起以那个模式开出的每一个仓位。仓位默认以全仓保证金开出;逐仓保证金是你为每个仓位做的选择。

订单簿上的一笔订单

订单簿的运作基本上和中心化交易所的一样,而且完全在链上。价格必须是最小变动价位的整数倍,数量必须是最小交易单位的整数倍,订单按价格优先、时间优先撮合。

保证金要核查两次。一次是新订单开出的时候,另一次是每笔订单撮合时对挂着的那一边,这样即使挂单之后预言机价格动了,保证金机制仍然自洽。

链自己知道什么是订单。在一个区块之内,动作被分成三组排序:先是不向任何订单簿发送 GTC 或 IOC 订单的那些,然后是撤单,最后是至少发送一笔 GTC 或 IOC 订单的那些,每一组内部保持区块提议者给出的次序。一个区块通常装着一到两批共识动作。

它答得有多快

端到端,从发出请求到收到已提交的回应,文档给出的中位数是 0.2 秒,第 99 百分位是 0.9 秒,针对的是从地理上就近部署的客户端发出的一笔订单。主网大约支持每秒 200,000 笔订单,而文档说瓶颈在执行,不在共识。

对任何自动化的东西来说,这有两个后果。一个决定在远不到一秒内就被确认,所以程序不必去猜自己的订单到没到;而一个离 API 服务器很远的程序,受自己网络的约束会先于受链的约束。

签名、API 钱包和 nonce

每一个动作都要签名。除了账户自己的密钥,一个主账户还可以批准 API 钱包(文档也把它们叫做代理钱包)替账户或者替它的子账户签名。一个账户可以持有一个未命名的已批准钱包和最多三个命名的,每个子账户再加两个命名代理,而用 valid_until 设定的到期时间最远只能在 180 天之后。

API 钱包只管签名,别的什么都不做。查询账户数据要用账户的真实地址,而文档把查询代理地址点名为一个常见陷阱:它返回的是空结果,而不是报错。

这里的 nonce 不是以太坊的那一种,因为一本订单簿没法一次只等一笔交易。Hyperliquid 为每个签名者保留最高的 100 个 nonce;一个新动作带的 nonce 必须高于这一组里最小的那个、从未用过,而且落在它所在区块时间戳之前两天到之后一天的范围内。

绝不要重用一个代理地址

一个 API 钱包的 nonce 状态可能被清掉:在批准新钱包而把它注销时、在它到期时,或者在注册它的那个账户资金耗尽时。文档警告说,此前签过的动作届时可能被重放。生成一个新的 API 钱包,而不要把一个旧地址救回来用。

把美元弄出来

提币从 Hyperliquid 上的一次签名开始,不需要你在另一条链上发任何交易:验证者签好,再把请求发给桥合约。文档给出的手续费是写作时的 $1,最终确认大约要五分钟。

能发出那个请求的是谁,比它要多久更重要。一个已批准的 API 钱包不能:2026 年 9 月 28 日在主网上用一把新的代理密钥实测,withdraw3、usdSend、spotSend、sendAsset 和 usdClassTransfer 在这个签名者上全部被拒,而同样的载荷由账户本身签名,遇到的则是余额不足的错误。

这就是为什么可以给一个智能体一把密钥。交易的密钥和搬钱的密钥,是两把不同的密钥。