Hyperliquid Recovery Bot User Guide

English

Select Language
简体中文

English

Select Language
简体中文

Appearance

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 ​