February 18

How to Withdraw Funds if Your Address is Flagged by Hyperliquid

If you've encountered the message:

"Your address has been flagged as high risk by a third-party screening tool. This frontend interface does not support connection to the Hyperliquid blockchain by high-risk addresses. If you think this is an error, you can open a support ticket."

and need to withdraw your funds, follow these steps.

Option 1: Using a Trading Bot (Telegram)

You can use a Telegram trading bot to withdraw your funds. You simply need to import your private key. This method is fast and easy, but if you're concerned about security and privacy, you can opt for the second method (manual).

HypurrFunBot Telegram Trading Bot

Option 2: Manual Withdrawal Using Ubuntu Server

If you want a more secure and customizable approach, follow these steps using an Ubuntu server. You can rent a server from Hetzner or any other service provider that supports Ubuntu.

Step 1: Rent a VPS (Optional)

Rent a VPS (Virtual Private Server) from a provider like Hetzner.

  • Visit Hetzner: Hetzner Cloud
  • Choose the Standard VPS plan (or any other according to your needs).
  • Once you've rented the server, log in using SSH.

Step 2: Install Python and Necessary Libraries

Update your system:

sudo apt update
sudo apt upgrade -y

Install Python 3:

sudo apt install python3 python3-pip -y

Install virtualenv to create a virtual environment:

sudo apt install python3-venv -y

Create a virtual environment:

python3 -m venv hyperliquid-env
source hyperliquid-env/bin/activate

Install necessary libraries:

pip install hyperliquid-python-sdk requests python-dotenv

Step 3: Prepare the Environment

Create a .env file to store your private key and API wallet address securely. Use the nano editor:

nano ~/.hyperliquid.env

Add your API Wallet Address and Private Key:

Open the .env file and add the following (replace YOUR_API_WALLET and YOUR_PRIVATE_KEY with actual values):

API_WALLET=YOUR_API_WALLET
PRIVATE_KEY=YOUR_PRIVATE_KEY

Save the file by pressing Ctrl + X, then Y, and then Enter.

Step 4: Set Up the Script

Create a Python script to interact with the Hyperliquid API.

nano transfer_to_spot.py

Paste the following code into the file (this example will help you transfer USDC to a spot wallet):

from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
from eth_account import Account
import os
from dotenv import load_dotenv

load_dotenv()

# Load API wallet and private key from environment variables
api_wallet = os.getenv("API_WALLET")
private_key = os.getenv("PRIVATE_KEY")

# Create account object from private key
wallet = Account.from_key(private_key)

# Initialize Exchange object
exchange = Exchange(base_url=constants.MAINNET_API_URL, wallet=wallet)

# Amount to transfer
amount = 100.0  # 100 USDC

# Perform spot transfer
response = exchange.spot_transfer(amount, api_wallet)
print(response)

Save and close the file (press Ctrl + X, then Y, then Enter).

Step 5: Run the Script

Run the script to transfer the funds:

python transfer_to_spot.py

Step 6: Withdraw Funds Through the Bridge

Once your funds are in the spot wallet, you can withdraw them through the bridge to another wallet.

Create another script for the withdrawal process:

nano withdraw_to_arbitrum.py

Paste the following code into the file:

from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
from eth_account import Account
import os
from dotenv import load_dotenv

load_dotenv()

# Load API wallet and private key from environment variables
api_wallet = os.getenv("API_WALLET")
private_key = os.getenv("PRIVATE_KEY")

# Create account object from private key
wallet = Account.from_key(private_key)

# Initialize Exchange object
exchange = Exchange(base_url=constants.MAINNET_API_URL, wallet=wallet)

# Amount to transfer
amount = 50.0  # 50 USDC
destination_address = "0x1234567890abcdef1234567890abcdef12345678"  # Your withdrawal address

# Send the transfer through the bridge
response = exchange.withdraw_from_bridge(amount, destination_address)
print(response)

Save and close the file.

Step 7: Run the Withdrawal Script

Execute the script to withdraw the funds:

python withdraw_to_arbitrum.py

Check if the withdrawal was successful. If everything is set up correctly, your funds will be sent to the provided address.


By following these steps, you can manually withdraw your funds from Hyperliquid if your account is flagged by the third-party screening tool. If you're concerned about security, you can use the Telegram bot method.

Good luck!