Overview
In this guide, we’ll show you how to bconnect your HyperLiquid account to Bothub using MetaMask (or another crypto wallet).
You’ll learn how to authorize your wallet, make a deposit, create an API key, and finalize the secure connection to Bothub.
💡 Estimated setup time: 10–15 minutes
Step 1 — Open the HyperLiquid Website
1. Go to hyperliquid.xyz.
2. In the top-right corner, click Connect.
3. From the list of login options, select MetaMask (or your preferred wallet).
4. When MetaMask opens, click Connect to authorize the connection.
Step 2 — Accept Terms and Sign the Request
After selecting MetaMask, you’ll be prompted to:
1. Review and accept the Terms of Use, Privacy Policy, and Cookies Policy.
2. Click Accept,
3. MetaMask will then display a signature request — click Sign or Confirm to complete the login process.
Once done, you’re officially logged in to HyperLiquid using your wallet.
Step 3 — Make a Deposit (Required Before API Creation)
HyperLiquid requires a minimum deposit before you can generate an API key.
1. In the top-right corner, click Deposit.
2. In the deposit modal, choose:
Asset: USDC
Network: Arbitrum
Copy your wallet address
3. Send at least 5 USDC to this address.
Once the transfer is confirmed on the blockchain, the balance will appear in your HyperLiquid dashboard.
⚠️ Important: Even if you already have USDC in MetaMask, you must still transfer it to your HyperLiquid balance. The minimum deposit is 5 USDC, but we recommend sending a bit more to cover network fees and bot allocation needs.
Once the transfer is confirmed, your balance will appear on the HyperLiquid dashboard — just below the main trading section.
Step 4 — Copy Your General Wallet Address
Once your funds are visible:
1. Click on your profile icon in the top-right corner.
2. Copy your General Wallet Address (it’s displayed under your account name).
3. Go to Bothub → Connect Exchange → HyperLiquid.
4. Paste the General Wallet Address into the required field.
Step 5 — Create an API Key on HyperLiquid
1. In the navigation bar, click More → API.
2. In the Name field, enter a label (for example: “Bothub Trade”).
3. Under Address of API Wallet, click Generate — this will create your API wallet address.
4. Then click Authorize API Wallet.
5. In the Validity field, select Max (180 days) to keep your API active for the longest period.
🕒 After 180 days, you’ll need to renew your API key — don’t worry, BotHub will remind you in advance.
Step 6 — Copy and Authorize Your Keys
At the top of the page, you’ll now see:
Your API Wallet Address
Your Private Key
1. Copy both keys.
2. Go to Bothub → Connect Exchange → HyperLiquid.
3. Paste the API Wallet Address and Private Key into the corresponding fields.
⚠️ Don’t click “Connect” yet — you still need to authorize the key on HyperLiquid.
Return to HyperLiquid and click Authorize to finalize API key creation.
If successful, you’ll see your new key appear in the API key list.
Now go back to Bothub and click Connect.
Step 7 — Verify Connection
After connection:
Your HyperLiquid account will appear in your Exchange List.
You can now allocate funds and activate bots on your dashboard.
Check the Activity Log to confirm that your bots are trading correctly.
Troubleshooting
If you encounter an error while connecting:
Double-check that your IP address is correctly added on Binance.
Make sure withdrawal permission is not enabled.
Ensure your API key is active (not expired or deleted).
Try creating a new API key if the issue persists.
If none of these steps help, reach out to our Support Team via the in-app chat or email us at [email protected] — we’re always here to help.