サブウォレットとマルチ取引所

🟡 中級者向け: サブウォレットは実資金を保有します。各 ウォレットは作成時に 1 つの取引所に紐づき、その紐付けは ライフタイム中変更できません。

サブウォレットは独立した永続先物アカウントです。複数持つことが できます: Wallet A は Hyperliquid で手動スイング、Wallet B は Lighter でコピートレード bot、Wallet C は特定のテーマ用に確保、 というように。各サブウォレットには独自のエクイティ、ポジション、 注文、取引履歴があります。残高は共有されません；どこに入れたか で資金は留まり続け、自分で出金または送金しない限り動きません。

取引対象のサブウォレットは、その取引がどの取引所で約定するかも 決定します。ウォレットを切り替えれば、次の long BTC は別の 会場へ自動的にルーティングされます: フラグも切り替えも不要です。

現在利用可能な取引所

現在、サブウォレットを以下のいずれかの取引所に紐づけできます。 今後さらに追加予定です。API の SupportedExchange 値はオープン エンドで時間と共に拡張されるため、統合側は現在のセット外の値も 許容するべきで、厳密一致を前提にしないでください。

「Create Sub-wallet」モーダルではこれらが小さなチップで表示 されます：

• 流動性が高い: Hyperliquid
• 手数料が安い: Lighter

🟢 初回ユーザー推奨：Hyperliquid から始めるのが無難です。 多くのユーザーの取引サイズでは深い板が滑らかな約定を吸収し、 取引量が本格化するまでは手数料差より対応銘柄数のほうが重要です。

ライフサイクル：creating → active → error

サブウォレットを作成すると、上流は紐付けた取引所にオンチェーン ウォレットを生成するためにしばらく時間をかけます。その間、 ピッカーには creating バッジ付きで表示され: 取引には使えず、 テーブルビューは空の状態を表示します。通常 1 分以内に完了します。

• creating: 作成中。ウォレットは表示されるが利用不可。ピッカー オプションがグレーアウト。テーブルは空行を表示。
• active: 利用可能。取引・入金・出金が通常通り動作。
• error: 作成失敗。失敗したサブウォレットを削除して新しい ものを作成することを推奨します；上流の問題は通常一時的です。

サブウォレットの作成

Portfolio → Perps タブで、ヘッダーの + Create sub-wallet を クリック。モーダルが開き、2 つのフィールドがあります：

• Name: 最大 20 文字、任意の文字種。一目で識別できるもの （BTC swing、Lighter test）を推奨。
• Exchange: Hyperliquid または Lighter。それぞれのチップ （流動性が高い / 手数料が安い）が表示されます。

送信。新しいウォレットは creating バッジ付きでピッカーに即座に 表示され、上流が応答すると active に変わります。リロードは不要 ピッカーは 15 秒ごとにサブアカウントリストをポーリングします。

Spot タブからも作成できます: Perps Value カードのウォレット ピッカーの隣にある + アイコンが同じモーダルを開きます。新しい ウォレットの最初の取引前に入金を整える際に便利です。

サブウォレットのリネーム

名前は表示用のみ: ウォレットのアドレス、取引所の紐付け、開いて いるポジションに影響を与えずに自由にリネームできます。

ピッカーでウォレットを選び、✎ 鉛筆アイコンをクリック。モーダル は現在の名前を選択済み状態で予め埋めるため、最初のキー入力で値 全体が置き換わります。送信すると、そのウォレットが参照されている 全ての場所（ピッカー、エクイティカード、Deposit / Withdraw モーダル） に新しい名前が反映されます。

知っておくと良い 2 つのセーフガード：

• リネーム対象はクリック時にスナップショットされます。編集中に ピッカー選択を変更しても、モーダルは元々鉛筆をクリックした ウォレットに対してリネームをコミットします。
• モーダルを開いてから送信を試みる間に別のタブでウォレットが 削除されている場合、モーダルは短い「もう存在しません」通知を 表示してクローズできます。古い対象に対するリネームは保存 されません。

Perps Value カードのウォレットピッカー隣にもリネームボタンが あるため、Spot タブからもリネーム可能です。

ポートフォリオ全体でのウォレット切り替え

ウォレット ピッカーは 1 つで、2 か所に表示されます：

• Portfolio Perps タブ ヘッダー: Perps タブのみ表示。Rename
  • Create の隣。
• Perps Value カードのタイトル行: Spot と Perps の両方で 表示。エクイティ数値の隣。

両方の表示位置で同じ ?wallet=<address> URL パラメータを読み書き するため、一方での選択は即座に他方に反映されます。URL は共有 / リロード可能なディープリンクでもあり: 選択状態をチャットに ドロップしたり、チームメイトに渡したり、戻るボタンで戻ったり できます。

最後の明示的な選択は localStorage にも永続化されます。ページの リロード、他ルートからの復帰、ブラウザの再起動: いずれの場合 でもピッカーはリストの先頭ではなく最新の選択をデフォルトに します。ディープリンク（URL に ?wallet=…）は引き続き優先され、 localStorage は URL が空の場合のフォールバックです。

ウォレット別のエクイティ・ポジション・注文

ウォレットを選択すると Perps Value カードはそのウォレットに スコープされます：

• Available to Trade: 紐付けた取引所での出金可能残高。
• Account Equity: このサブウォレットの純資産。
• uPnL: オープンポジション横断の未実現損益。

カード下のすべての永続先物テーブル: Position、Open Orders、 Trade History、Funding History、Order History: が同じウォレット にスコープされます。ピッカーを切り替えると、テーブルは新しい ウォレットのデータが到着する前に短くロード スケルトンを表示し、 直前のウォレットの行をフラッシュ表示することはありません。

Total Value（カード上部のヘッドライン）は全サブウォレット 横断で集計され、Spot を含みます。ピッカーを変更しても変わらない Perps Value カードのみ変わります。

取引所間の取引執行

すべての永続先物アクションは 1 つの統一 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 フラグを渡す必要はありません。

ピッカーを切り替えずに特定のウォレットで取引したい場合、プロンプト 内で指定してください：

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

Agent はウォレット名 + 取引所で区別し、正しいサブを選びます。

入金と出金

Deposit モーダルは取引所ではなくサブウォレット単位で送信先を選び ます。ウォレットのドロップダウンの各オプションには取引所ロゴ、 名前、ウォレットの入金アドレスが表示されます。Hyperliquid と Lighter はどちらも現在 Arbitrum 上の USDC を受け付けます。

Withdraw モーダルも同じ仕組み: ソース ウォレットを選び、金額と 宛先アドレスを入力して確認します。Settings → Security で出金 2FA を有効化している場合、モーダルは送信前に 6 桁コードを 求めます；有効化していない場合、コードフィールドはスキップ されます。

既知の制限

• サブウォレットの取引所紐付けは永続的。別の取引所で運用したい 場合は新しいウォレットを作成してください: その場での移行は ありません。
• 集約ポートフォリオ読み取り（全サブウォレットを横断した合計）は 現在も Hyperliquid デフォルト DEX ビューを優先: 完全な Lighter 対応集約に取り組んでいます。ウォレット別ビュー（特定の ウォレット選択時）は既に取引所対応で正確です。
• 各サブウォレットは紐付け先取引所に独自の EOA を持ちます。異なる 取引所のサブ間で USDC を移動する内部送金ショートカットはまだ ありません: USDC を移動するには、現物ウォレットに出金してから 対象サブに入金してください。