子錢包與多交易所

🟡 中級：子錢包持有真實資金。每個子錢包創建時綁定一個交易所， 綁定關係生效後無法更改。

子錢包是一個獨立的永續合約賬戶。你可以有多個：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，需要先提現到現貨錢包， 再充值到目標子錢包。