子钱包与多交易所

🟡 中级：子钱包持有真实资金。每个子钱包创建时绑定一个交易所， 绑定关系生效后无法更改。

子钱包是一个独立的永续合约账户。你可以有多个：Wallet A 跑 Hyperliquid 上的手动波段，Wallet B 跑 Lighter 上的跟单机器人， Wallet C 留给某个特定主题。每个子钱包有自己的权益、仓位、挂单和 交易历史。它们之间不共享余额；放进哪个钱包就留在哪个，除非你 主动提现或转账。

下单时用哪个子钱包，也决定了这笔交易在哪个交易所成交。切换钱包， 下一条 long BTC 就路由到不同的场所，不用任何参数、也没有开关。

当前可选交易所

目前可以把子钱包绑定到下列任一场所。后续会接入更多：API 上的 SupportedExchange 是开放枚举，将随平台扩展而扩展，集成方应该 容忍超出当前列表的值，而不是断言完全匹配。

在「创建子钱包」弹窗里，这两个选项旁边会有小徽标提示：

• 流动性更好：Hyperliquid
• 手续费更低：Lighter

🟢 新手推荐：从 Hyperliquid 起步。多数用户的交易规模下，更深的 盘口能稳定吸收成交、避免滑点；只要你的成交量还没起来，覆盖范围 比微小的费率差更重要。

生命周期：creating → active → error

新建子钱包时，上游需要一点时间在绑定的交易所上完成链上钱包的开通。 这段窗口内 picker 里会有一条带 creating 状态徽标的钱包：暂时 无法用来交易，相应表格渲染空状态。一般一分钟内完成。

• creating：创建中。钱包已出现但还不能用，picker 里这条 disabled， 表格里没有数据。
• active：已就绪。可正常交易、充值、提现。
• error：创建失败。建议删掉这条重新创建，上游问题通常是临时的。

创建子钱包

进入 Portfolio → Perps tab，点击头部的 + Create sub-wallet 按钮。弹窗里有两个字段：

• Name：最多 20 个字符，支持所有语言。起个一眼能认出来的名字 （BTC swing、Lighter test）。
• Exchange：Hyperliquid 或 Lighter，旁边带「流动性更好」/ 「手续费更低」徽标。

提交后新钱包立刻出现在 picker 里，带 creating 徽标，上游返回成功 后翻为 active。不用刷新；picker 每 15 秒自动轮询子账户列表。

也可以从 Spot tab 创建：Perps Value 卡片的钱包 picker 旁边有个 + 图标，打开同一个弹窗。在新钱包首次交易前先管理它的充值时， 这个入口很顺手。

重命名子钱包

钱包名只是显示用：改名不会影响钱包的地址、交易所绑定，或任何 开仓。

在 picker 里选中目标钱包，点击 ✎ 铅笔图标。弹窗会预填当前名字 并全选，第一次按键就会替换整个值。提交后，新名字在所有引用这个 钱包的地方（picker、equity 卡片、Deposit / Withdraw 弹窗）即时 反映。

两个值得知道的保护机制：

• 重命名目标在点击时拍快照。就算你在编辑中切换 picker 到另一个 钱包，这次重命名仍然作用在你最初点铅笔时选的那个钱包上。
• 如果在你打开弹窗到提交期间，钱包在另一个 tab 被删除了，弹窗会 显示「不再存在」的简短提示，让你关闭。不会把名字保存到一个失效 的目标上。

Perps Value 卡片的钱包 picker 旁边也有这个铅笔按钮，可以从 Spot tab 直接重命名。

在 Portfolio 各处切换钱包

所有 picker 共享一份钱包列表，出现在两个位置：

• Portfolio Perps tab 头部：仅 Perps tab 可见，与 Rename 和 + Create 并排。
• Perps Value 卡片标题行：Spot 和 Perps 两个 tab 都可见，紧贴 权益数字。

两处读写同一个 ?wallet=<address> URL 参数，一处选择会立即同步到 另一处。URL 也是可分享 / 可刷新的深链：把选中状态发到聊天里、 传给团队成员，或者就靠浏览器后退键回到这条钱包。

你的最近一次选择还会持久化到 localStorage。刷新页面、从其他路由 返回，或者重启浏览器，picker 都会默认显示最近选过的钱包，而不是 列表里第一个。深链（URL 里带 ?wallet=…）优先；localStorage 是 URL 缺失时的兜底。

单钱包权益、仓位与挂单

选中钱包后，Perps Value 卡片里的数字 scope 到那个钱包：

• Available to Trade：绑定交易所上的可提现额度。
• Account Equity：这个子钱包的净值。
• uPnL：开仓未实现 PnL。

卡片下方的所有永续合约表：Position、Open Orders、Trade History、 Funding History、Order History：都 scope 到同一个钱包。切换 picker 后，表格会先短暂显示加载骨架屏，然后再渲染新钱包的数据，而不是 闪过上一个钱包的内容。

Total Value（卡片上方的总览数字）跨所有子钱包聚合，包含 Spot。 切换 picker 时它不变；只有 Perps Value 卡片 re-scope。

跨交易所的交易执行

所有永续合约动作走统一的 API： /v1/trading-gateway/*。 你不用按交易选场所：目标场所由要交易的子账户隐式决定：

• POST /v1/trading-gateway/place-orders：开仓 / 平仓 / 附加 TpSL
• POST /v1/trading-gateway/cancel-orders：批量撤单
• POST /v1/trading-gateway/modify-order：调整活动订单的价格 / 数量 / 触发价
• POST /v1/trading-gateway/update-leverage：一次调整杠杆 + 保证金模式
• POST /v1/trading-gateway/update-isolated-margin：增加或扣回 逐仓保证金
• POST /v1/trading-gateway/withdraw：USDC 提现（如果你在 Settings → Security 启用了提现 2FA， 需要 TOTP）
• GET /v1/trading-gateway/summary：单钱包的权益、仓位、挂单

聊天里你说 long BTC，Agent 会用当前选中子账户的 id 调用 place-orders。这个 id 绑定的交易所是隐式的，你永远不用传 --exchange 这种参数。

如果想在不切换 picker 的情况下在特定钱包上下单，可以在提示词里 点名：

long BTC with 5x on Wallet A
short ETH on the Lighter wallet

Agent 会按钱包名 + 交易所组合消歧，挑出正确的子钱包。

充值与提现

Deposit 弹窗按子钱包维度选目标，不按交易所选。下拉的每个选项显示 交易所 logo、钱包名、和这个钱包的充值地址。Hyperliquid 和 Lighter 当前都接收 Arbitrum 上的 USDC。

Withdraw 弹窗同样按子钱包选源钱包，输入金额和目标地址确认。如果 你在 Settings → Security 启用了提现 2FA， 弹窗会在提交前要求输入 6 位验证码；没启用就不显示验证码输入框。

已知限制

• 子钱包的交易所绑定永久生效。想要某个钱包换交易所，只能新建 一个：不支持原地迁移。
• 跨子钱包的聚合视图（多个钱包数据求和）目前仍优先取 Hyperliquid default dex；完整的 Lighter aware 聚合在开发中。单钱包视图（picker 选中具体钱包时）已经是 exchange aware 且准确的。
• 每个子钱包在它绑定的交易所上有自己的 EOA。不同交易所的子钱包之间 暂时没有内部转账快捷方式：要移动 USDC，需要先提现到现货钱包， 再充值到目标子钱包。