文档
你想做什么？
连接 Hyperliquid
Hyperliquid 使用 API 钱包：由您的主账户授权的委托密钥，可以下单但不能提现。MyLiquidBot 需要您的主账户地址（资金所在地址）和 API 钱包私钥。绝不需要您主钱包的私钥和助记词。
用邮箱或社交登录创建的 Hyperliquid 账户不兼容。请使用用您自己钱包（MetaMask、Rabby、Coinbase Wallet 等）创建的账户。
在添加连接中选择 Hyperliquid，并保持选中快速连接。按连接浏览器钱包或 WalletConnect，用您 Hyperliquid 账户的主钱包签名：MyLiquidBot 创建 API 钱包，Hyperliquid 将其关联到您的账户，向导随后进入激活交易。不转移资金，不花费 gas，该密钥永远不能提现。有效期约 180 天；请在到期前通过管理 → API 钱包再签名一次续期。如果想自己创建，请选择粘贴 API 密钥并按第 1、2 部分操作。
第 1 部分 — 在 Hyperliquid 创建 API 钱包
用您的主钱包打开 Hyperliquid
访问 app.hyperliquid.xyz，连接拥有该账户并持有资金的钱包，并确保已存入 USDC。
打开 API 页面并生成 API 钱包
从 Hyperliquid 菜单打开 API 页面，为 API 钱包命名，生成它并用您的主钱包授权。Hyperliquid 只显示一次 API 钱包的私钥：请复制到密码管理器中。
注意有效期
若 Hyperliquid 要求设置有效期，请选择适合您的期限并记住它。API 钱包过期后，连接会停止交易，您必须创建新的 API 钱包并编辑连接。
第 2 部分 — 在 MyLiquidBot 添加连接
前往账户 → 交易所 → 添加连接，选择 Hyperliquid，确认账户是用您自己的钱包创建的，然后填写：
| MyLiquidBot 中的字段 | 填写内容 |
|---|---|
| 连接名称 | 任意标签，至少 3 个字符，例如 Hyperliquid Main。 |
| 钱包地址 | 您的主账户地址（0x…）— 在 Hyperliquid 持有资金的钱包。不是 API 钱包地址。 |
| Hyperliquid API 钱包 - 私钥 | 创建 API 钱包时只显示一次的私钥（64 个十六进制字符，带或不带 0x）。 |
| Vault 地址（可选） | 仅当您交易自己管理的 Hyperliquid vault 时填写。大多数用户留空。 |
| API URL（可选） | 留空。 |
按保存并验证。MyLiquidBot 会检查该密钥是否为该账户授权的有效 API 钱包。
第 3 部分 — 激活交易（Builder 费用）
连接主钱包
在激活步骤（或之后在管理 → 交易激活中）按连接钱包，选择浏览器钱包或 WalletConnect。使用连接中保存的同一主钱包。
按“激活交易”并签名
您的钱包会请求签名。这不是交易，不花费 gas，不转移资金，也绝不允许提现。只有账户已有入金时 Hyperliquid 才接受它。
检查状态
当面板显示交易已激活时，机器人和手动订单即可使用该连接。若显示需要更新，请再次激活。若有待处理的同步，请打开高级 → 重试同步。
在 Hyperliquid 上无需事先设置杠杆。机器人创建器和交易下单面板会同步您为每个市场选择的杠杆和全仓/逐仓模式。
故障排除
| 消息或症状 | 可能原因 | 解决方法 |
|---|---|---|
| “Hyperliquid API 钱包私钥与钱包不匹配，且未列为该账户已批准的 API 钱包。” | 钱包地址不是授权该 API 钱包的账户，或者 API 钱包已过期或被移除。 | 在钱包地址中填入主账户地址。在 Hyperliquid 的 API 页面检查该 API 钱包是否仍在列表中；若不在，请创建新的并编辑连接。 |
| “Hyperliquid API 钱包私钥格式无效…” | 密钥不完整、有多余空格，或粘贴的是地址而不是密钥。 | 重新粘贴完整的 64 字符私钥。 |
| “钱包地址无效。必须使用 0x 格式。” | 地址错误或被截断。 | 复制主钱包完整的 0x… 地址。 |
| 余额显示 0 | 钱包地址中填的是 API 钱包地址，或账户没有入金。 | 编辑连接并填入主账户地址；在 Hyperliquid 存入 USDC。 |
| “Hyperliquid 要求此账户先有入金才接受批准。” | 该账户从未收到过入金。 | 在 Hyperliquid 向该钱包存入 USDC，然后再次激活。 |
| “打开连接中保存的同一钱包” | 钱包中选择了另一个账户。 | 将钱包切换到连接中保存的主账户并重新签名。 |
| 交易曾正常，之后停止 | API 钱包已过期或被撤销。 | 创建新的 API 钱包，用新密钥编辑连接并保存。 |