Hyperliquid API 钱包（代理钱包）详解（2026）：权限、设置、风险与只读追踪

简要：Hyperliquid API 钱包（又称代理钱包 agent wallet）是由主钱包授权、可代为下单和撤单的独立密钥。它能交易，但不能提现。交易机器人、交易终端和 Telegram 交易工具都使用代理钱包。投资组合追踪工具完全不需要它：你的 Hyperliquid 数据是公开的，像 Hyperfolio 这样的只读工具只需要你的地址。

什么是 Hyperliquid API 钱包？

Hyperliquid 上的每个操作（下单、撤单、调整杠杆）都是私钥签名的消息。每次用硬件钱包签名太慢，把主私钥交给机器人又很危险。代理钱包解决了这个问题：生成一对新密钥，由主钱包签署一次 approveAgent 操作，授权该地址代你交易。之后机器人用代理密钥签名，订单仍进入你的账户。

代理钱包能做与不能做的事

操作	代理钱包	主钱包
下单、改单、撤单	可以	可以
调整杠杆/保证金模式	可以	可以
为你的子账户和金库交易	可以（vaultAddress）	可以
提现到外部地址	不可以	可以
向他人转 USDC 或代币	不可以	可以
授权新代理	不可以	可以

代理密钥泄露无法直接盗走资金，但攻击者仍可开巨额杠杆仓位或在流动性差的市场交易造成亏损，请妥善保管。

如何创建 API 钱包

1. 在 app.hyperliquid.xyz 连接主钱包，从菜单打开 API 页面。
2. 生成新的 API 钱包（或填入自建地址），命名并可设置有效期。
3. 用主钱包签名授权。私钥只显示一次，请存入机器人的密钥管理中，切勿写进代码或聊天。
4. 机器人用代理密钥签名，但查询和交易时使用主账户地址。查询代理地址是最常见的错误：它本身没有余额。

Hyperliquid 限制每个账户的命名代理数量，用相同名称授权新代理会替换旧代理。请以官方文档的最新限制为准。代码示例见 Python API 指南和交易机器人指南。

Nonce：每个机器人一个代理

Hyperliquid 按签名者跟踪 nonce，每个操作都需要最新且唯一的 nonce（通常是毫秒时间戳）。多个进程共用一个代理密钥会导致 nonce 冲突、订单随机被拒。请为每个机器人单独创建代理钱包，也不要复用已注销的代理地址。

安全清单

• 自行或在官方应用中创建代理密钥，绝不把主助记词粘贴到机器人、终端或“AI 交易”网站。
• 要求你授权代理的第三方工具可以操作你的账户，只授权可信工具，并撤销不再使用的。
• 尽量设置有效期，出现事故后轮换密钥。
• 在专用子账户中运行机器人。
• 阅读钱包安全指南。

如何查看已授权的代理

curl -s https://api.hyperliquid.xyz/info \
  -H 'Content-Type: application/json' \
  -d '{"type":"extraAgents","user":"0x你的主地址"}'

若发现不认识的名称或地址，请在 API 页面删除并检查近期成交。

追踪投资组合需要 API 钱包吗？

不需要。Hyperliquid 上的余额、仓位、成交、资金费和盈亏都是按地址公开的链上数据。要求 API 密钥、代理授权或签名才能“显示盈亏”的追踪工具索取了不必要的权限。Hyperfolio 免费且只读：粘贴地址（以及子账户和机器人账户），即可查看权益、永续仓位、已实现和未实现盈亏、手续费和资金费，无需任何密钥。详见无需 API 密钥追踪 Hyperliquid。

示例：安全监控机器人

你在子账户“bot-eth”中用代理钱包运行 5000 美元的网格机器人，它无法提现。手机上用 Hyperfolio 只读观察“bot-eth”和主账户，每天查看机器人的交易盈亏扣除手续费和资金费后是否仍为正（真实盈亏指南），手机上无需存放任何密钥。

常见问题

API 钱包能提走我的资金吗？

不能。代理钱包只能交易，不能提现或转账，只有主钱包可以。

API 钱包和子账户一样吗？

不一样。子账户有独立余额；代理钱包是没有资金、代账户交易的签名密钥。

为什么机器人显示余额为零？

你可能在查询代理地址，请改为查询主账户或子账户地址。

如何撤销代理？

在 Hyperliquid 应用的 API 页面删除，或在设置了有效期时让其过期。

Hyperfolio 需要 API 钱包吗？

不需要。它只按地址读取公开数据，从不索要密钥、代理授权或签名。

密钥用于交易，而非查看：在 Hyperfolio 免费只读追踪你所有的 Hyperliquid 账户。新用户使用推荐码 HYPERFOLIO 可享 4% 手续费折扣。