定义
一个主账户可以批准一些 API 钱包，代表它自己或者它的任何一个子账户签名。它们只用来签名：查账户数据必须传入这个账户的真实地址，而文档把查询代理地址列为一个常见的坑，因为它返回的是一个空结果，不是一个错误。一个账户可以持有一个未命名的已批准钱包和最多三个命名的，每个子账户再允许两个命名代理，而用 valid_until 设定的到期时间最远只能在 180 天之后。
这样一个密钥能做什么、不能做什么，是实测出来的，不是假定的。2026 年 9 月 28 日，在主网上，一个测试账户批准了一个新代理，有效期一小时，让它对着一个大约 60 的余额，为 1,000 USDC 签署每一个会动用资金的动作，这样什么都动不了，只有每个回答的理由才算数。在这个签名者上被拒的是：withdraw3、usdSend、spotSend、sendAsset、usdClassTransfer、第二个 approveAgent 和 approveBuilderFee，而账户自己遇到的则是一个余额错误。被接受的是：下单和撤单。还有一次资金变动被接受了，vaultTransfer，用它，由代理密钥签出的 5 USDC 进了一个 Hyperliquid 金库。
有一条运维上的警告应该和这个定义放在一起。nonce 是按签名者分别记录的，而一个 API 钱包的 nonce 状态可能被清理掉：当它因为一个新钱包获批而被注销时、当它到期时，或者当注册它的那个账户不再有资金时。文档说，此前已签署的动作在那之后可能被重放，并强烈建议永远不要重用一个代理地址：请改为生成一个新的。
在我们自己这套安排里，代理密钥待在电脑上，带着一个密码封在磁盘里，只有在解锁期间才由守护进程持在内存中。守护进程只为一份封闭的交易动作清单签名，别的都不签；这个密钥会自己到期，并在 30 天、14 天、7 天、3 天和 1 天前发出提醒，而 lpa agent revoke 会用你的钱包把它退役。电脑上没有哪个文件能拦住一个同时拿到密钥和它密码的窃贼，所以真正站得住的那条界是账户：它里面有多少，就是最多能亏掉多少。
例子
一个例子，数字取整。一个存入 1,000 USDC 的账户批准一个代理密钥，到期时间定在 180 天之后，也就是 Hyperliquid 允许的上限。这个密钥能拿这 1,000 USDC 开仓和平仓，能设一个市场的杠杆和保证金模式；它不能从里面提走一分钱，不能把它转去另一个地址，也不能在现货余额和永续余额之间划转。它能碰到的全部就是那 1,000 USDC，这就是为什么一个专用账户才是要紧的那条界。