Quick Start

This page gives you a 5-minute path to complete your first detection and recovery run.

Use this workflow if your address can connect in Hyperliquid frontend but a red high-risk warning overlay appears and common operation buttons are typically disabled or restricted.

1) Open the Bot

2) Run Address Detection First

  1. Tap 🔍 Address Detection or send /detect
  2. Enter the source address (0x prefix, 42 chars)
  3. Wait for the bot to scan your spot, perpetual, vault, and staking-related assets
  4. Review total value, any waiting or locked assets, and what can be handled now

3) Start Asset Recovery

  1. Tap 🛠️ Asset Recovery or send /recovery
  2. Enter source address (flagged address)
  3. Enter private key or mnemonic (used only for signing)
  4. Confirm plan and fee breakdown, then execute

Note: if some assets cannot be handled yet, the preview will show that they need to wait instead of making them look immediately available.

4) What You Will See

  • A guided multi-step progress view
  • Step-by-step status updates showing whether each part finished, is waiting, was skipped, or failed
  • A result page telling you whether the run is complete, partial, needs another run later, or failed
  • A final summary with recovered amount, actual fees, and transaction hashes

5) Fee Semantics

  • Service Fee: 0.5%, minimum 1 USDC
  • Withdrawal Fees: 2 USDC (two withdrawals)
  • Total Cost: Service Fee + Withdrawal Fees
  • You Will Receive: Estimated Recoverable Value - Total Cost

See Fee and Settlement for full examples.

6) Special Cases

  • Staked assets: may require waiting windows; bot tells you when to rerun.
  • Locked vault assets: assets that are temporarily unavailable will be marked as waiting and can be retried later.
  • Small balances: some steps may not be generated due to minimum withdrawal limits.
  • Arrival latency: after withdrawal is submitted, funds may arrive in several to more than ten minutes depending on Hyperliquid processing.

7) Security Checklist

  1. Use the official bot only
  2. Operate on trusted device/network
  3. Verify the same source address can receive on Arbitrum
  4. Never screenshot or share credentials

Next Reading