서브 월렛 및 다중 거래소

🟡 중급: 서브 월렛은 실제 자금을 보유합니다. 각 월렛은 생성 시 단일 거래소에 바인딩되며, 그 선택은 월렛의 수명 동안 영구적입니다.

서브 월렛은 격리된 무기한 선물 계정입니다. 여러 개를 가질 수 있습니다: Wallet A는 Hyperliquid에서 수동 스윙용, Wallet B는 Lighter에서 카피 트레이드 봇용, 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을 클릭 하세요. 두 개의 필드가 있는 모달이 열립니다:

• Name: 최대 20자, 모든 문자. 한눈에 알아볼 수 있는 것을 사용하세요 (BTC swing, Lighter test).
• Exchange: Hyperliquid 또는 Lighter. 각자의 칩 라벨 (유동성 우수 / 수수료 저렴)과 함께 표시됨.

제출하면 새 월렛이 creating 뱃지와 함께 선택기에 즉시 나타나며, 업스트림이 응답하면 active로 전환됩니다. 새로고침할 필요는 없습니다; 선택기는 15초마다 서브 계정 목록을 폴링합니다.

Spot 탭에서도 생성할 수 있습니다: Perps Value 카드의 지갑 선택기 옆에 있는 + 아이콘이 동일한 모달을 엽니다. 새 월렛의 첫 거래 전에 입금을 관리할 때 유용합니다.

서브 월렛 이름 변경

이름은 표시 전용입니다: 월렛의 주소, 거래소 바인딩, 모든 오픈 포지션에 영향을 주지 않고 자유롭게 이름을 변경할 수 있습니다.

선택기에서 월렛을 선택한 다음 ✎ 연필 아이콘을 클릭하세요. 모달은 현재 이름을 필드가 선택된 상태로 미리 채워, 첫 번째 키 입력이 전체 값을 대체합니다. 제출하면 새 이름이 해당 월렛이 참조되는 모든 곳 (선택기, 자본 카드, Deposit / Withdraw 모달)에 표시됩니다.

알아두면 좋은 두 가지 안전장치:

• 이름 변경 대상은 클릭 시점에 스냅샷됩니다. 편집 중에 선택기 선택을 변경하더라도, 모달은 처음에 연필을 클릭한 월렛에 대해 이름 변경을 커밋합니다.
• 모달을 열고 제출하려는 사이에 월렛이 다른 탭에서 제거된 경우, 모달은 짧은 "더 이상 존재하지 않음" 알림을 표시하고 닫을 수 있게 합니다. 오래된 대상으로 이름이 변경되지 않습니다.

Perps Value 카드의 지갑 선택기 옆에도 이름 변경 버튼이 있어서 Spot 탭에서도 이름을 변경할 수 있습니다.

포트폴리오 전반에서 월렛 전환

단일 지갑 선택기가 있으며, 두 곳에 표시됩니다:

• 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 카드만 변경됩니다.

거래소 간 거래 실행

모든 무기한 선물 작업은 통합된 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를 이동하려면 현물 지갑으로 출금한 다음 대상 서브에 입금하세요.