Hyperliquid Wallet Not Connecting? Complete Troubleshooting Guide

Quick Fixes — Try These First

Before diving into specific issues, run through these steps. They resolve the majority of wallet connection problems in under a minute:

1. Unlock your wallet — MetaMask requires your password after being idle. Click the extension icon and enter your password.
2. Refresh the page — Press Ctrl + Shift + R (Windows) or Cmd + Shift + R (Mac) to hard refresh
3. Check the URL — Make sure you are on app.hyperliquid.xyz (not a phishing site)
4. Disable other wallet extensions — If you have multiple wallet extensions (Rabby, Coinbase Wallet, Phantom), disable all except the one you want to use
5. Switch to Arbitrum One — Open MetaMask and manually switch to the Arbitrum One network
6. Try an incognito window — This rules out extension conflicts and cache issues

Issue: Wallet Popup Does Not Appear

You click "Connect Wallet" on Hyperliquid but nothing happens. No MetaMask popup, no prompt, nothing.

Causes:

• MetaMask is locked (most common)
• Browser is blocking the popup
• Another wallet extension is intercepting the request
• MetaMask extension is disabled or crashed

Solutions:

1. Unlock MetaMask — Click the MetaMask icon in your browser toolbar. If you see a password prompt, enter it. Then go back to Hyperliquid and click "Connect Wallet" again.
2. Check for blocked popups — Look for a popup-blocked icon in your browser's address bar. Click it and allow popups from app.hyperliquid.xyz.
3. Disable conflicting extensions — Go to your browser's extension settings (chrome://extensions in Chrome) and temporarily disable every wallet extension except MetaMask. Reload Hyperliquid and try again.
4. Restart the extension — Toggle MetaMask off and back on in your browser's extension settings, or restart your browser entirely.

[Screenshot: Browser address bar showing popup blocked icon with allow option for app.hyperliquid.xyz]

Issue: Connection Rejected or Times Out

The MetaMask popup appears, you approve the connection, but Hyperliquid shows an error or the connection never completes.

Solutions:

1. Try again — Sometimes the first attempt fails due to a timing issue. Refresh and try once more.
2. Check your internet connection — Hyperliquid uses WebSocket connections that can be more sensitive to network issues than regular browsing. If your connection is unstable, the handshake may time out.
3. Disable VPN temporarily — Some VPNs interfere with WebSocket connections. If you are using a VPN, try disconnecting it briefly to test the connection, then reconnect after.
4. Check for firewall or antivirus blocking — Security software may block WebSocket connections to unfamiliar domains. Add app.hyperliquid.xyz to your allowlist.

Issue: Multiple Wallet Extensions Conflicting

If you have MetaMask, Rabby, Coinbase Wallet, Phantom, or other wallet extensions installed simultaneously, they can conflict over which one handles the connection request.

Symptoms:

• The wrong wallet pops up when you try to connect
• No wallet pops up at all (they are blocking each other)
• Connection succeeds but with the wrong wallet or address

Solutions:

1. Disable all wallet extensions except one — Go to chrome://extensions (Chrome) or about:addons (Firefox) and disable every wallet extension except the one you want to use with Hyperliquid
2. Use the wallet's built-in site connection — Some wallets (like Rabby) let you set which wallet handles connection requests for specific sites. Check the wallet's settings.
3. Use separate browser profiles — Create a Chrome profile that only has MetaMask installed, and use that profile exclusively for Hyperliquid

Issue: Wrong Network Error

Hyperliquid shows a network error, or MetaMask prompts you to switch networks.

Solutions:

1. Open MetaMask and click the network selector at the top
2. Select Arbitrum One
3. If Arbitrum One is not listed, add it manually:
   • Network Name: Arbitrum One
   • RPC URL: https://arb1.arbitrum.io/rpc
   • Chain ID: 42161
   • Currency Symbol: ETH
   • Block Explorer: https://arbiscan.io
4. Refresh Hyperliquid and try connecting again

For full wallet setup walkthroughs, see our guides for MetaMask, Rabby, Phantom, Coinbase Wallet, OKX Wallet, or Trust Wallet.

Issue: Mobile Connection Problems

Connecting to Hyperliquid from a mobile device has different challenges than desktop.

Using MetaMask Mobile (Recommended)

The most reliable mobile connection method is using MetaMask's built-in browser:

1. Open the MetaMask app on your phone
2. Tap the browser icon (compass icon at the bottom)
3. Navigate to app.hyperliquid.xyz
4. Tap "Connect Wallet" — MetaMask will connect automatically since you are inside the app

Using Safari or Chrome Mobile

If you prefer your regular mobile browser:

1. You will need to connect via WalletConnect
2. On Hyperliquid, select "WalletConnect" as the connection method
3. Scan the QR code with your wallet app, or tap the deep link
4. Approve the connection in your wallet app

Common mobile issues:

• WalletConnect session expired — Disconnect and reconnect. WalletConnect sessions can become stale.
• Browser switches back and forth — iOS sometimes struggles with the app-switching flow between browser and wallet. Be patient and wait for the wallet app to fully open before approving.
• Connection drops after locking phone — This is normal with WalletConnect. You may need to reconnect after your phone locks.

Issue: "Already Connected" or Stale Session

You see an error indicating the wallet is already connected, or the interface shows a wallet address but is not actually functional.

Solutions:

1. Disconnect from Hyperliquid — Look for a disconnect or logout option in the Hyperliquid interface (usually by clicking your wallet address)
2. Disconnect from MetaMask — Open MetaMask → click the three dots menu → Connected Sites → find app.hyperliquid.xyz → click the trash icon to disconnect
3. Clear site data — In your browser settings, clear cookies and site data specifically for app.hyperliquid.xyz
4. Refresh and reconnect — Hard refresh the page and connect your wallet again from scratch

Nuclear Option: Full Reset Steps

If nothing else works, this procedure eliminates every possible connection issue. It resets everything to a clean state.

1. Close all Hyperliquid tabs
2. Disconnect Hyperliquid from your wallet — MetaMask → Connected Sites → remove app.hyperliquid.xyz
3. Clear all browser data for Hyperliquid — Browser Settings → Privacy → Clear data for app.hyperliquid.xyz (cookies, cache, site data, local storage)
4. Disable all wallet extensions except the one you want to use
5. Restart your browser completely (close all windows, reopen)
6. Open a fresh tab and navigate to app.hyperliquid.xyz
7. Connect your wallet

If the nuclear option still does not work:

• Try a completely different browser — If you use Chrome, try Firefox or Brave
• Try an incognito/private window — This rules out all extensions and cached data
• Check Hyperliquid's status — The platform may be experiencing downtime. Check their Discord for announcements.

Related Guides

Wallet setup guides:

• MetaMask | Rabby | Phantom | Coinbase Wallet | OKX Wallet | Trust Wallet

Next steps:

• Deposit USDC to Hyperliquid — Fund your account after connecting
• How to Trade on Hyperliquid — Place your first trade

Frequently Asked Questions

Which wallets work with Hyperliquid?

Hyperliquid supports MetaMask, WalletConnect-compatible wallets, Rabby, and most EVM-compatible browser extension wallets. MetaMask is the most widely tested and reliable option. Hardware wallets like Ledger and Trezor work when connected through MetaMask as a hardware wallet account.

Why does MetaMask not pop up when I try to connect to Hyperliquid?

The most common causes are: MetaMask is locked and needs your password, the popup is being blocked by your browser, another wallet extension is intercepting the connection request, or MetaMask is disabled. Check that MetaMask is unlocked, disable other wallet extensions temporarily, and try allowing popups for app.hyperliquid.xyz.

Can I use Hyperliquid on mobile?

Yes. You can use the MetaMask mobile browser to access app.hyperliquid.xyz directly. Open the MetaMask app, tap the browser icon, and navigate to app.hyperliquid.xyz. Mobile browser connections through Safari or Chrome require WalletConnect, which can be less reliable than the in-app browser approach.

I connected the wrong wallet to Hyperliquid. How do I switch?

Disconnect your current wallet from the Hyperliquid interface, then disconnect Hyperliquid from within your wallet's connected sites settings. Clear your browser cache for app.hyperliquid.xyz, refresh the page, and connect with the correct wallet. If the old session persists, try an incognito window.