Tutorial 2.2: Hyperliquid API Keys - Connecting Your Exchange with USDC

Created by BITWHALE Official, Modified on Tue, 15 Apr at 10:56 AM by BITWHALE Official

Connecting your Hyperliquid decentralized exchange (DEX) account to BITWHALE allows you to trade directly through the platform, leveraging BITWHALE's tools like Whale Tracker and AI-powered trading. Hyperliquid requires USDC as the primary collateral, with a minimum of 100 USDC to start trading effectively. This tutorial will guide you through funding your Hyperliquid account, generating API keys on Hyperliquid, and linking them to BITWHALE.

Creating a Hyperliquid Account

Hyperliquid offers two ways to create or log into an account: using your email or connecting a wallet. We’ll use MetaMask as the default wallet, but you can choose any of the supported wallets shown in the screenshot.

Visit the Hyperliquid Website

Open your browser and go to app.hyperliquid.xyz/trade.
You’ll see a “Log in or sign up” prompt.

Choose Your Sign-Up Method
- Option 1: Connect with a Wallet (Default - MetaMask)
  - Click “Connect” to open the wallet selection menu (first screenshot).
  - Select “MetaMask” (or another wallet like Keplr, Cosmostation Wallet, Pontem Wallet, WalletConnect, OKX Wallet, or Coinbase Wallet).
  - MetaMask will pop up; ensure you’re on the Arbitrum network, then click “Connect” and sign the transaction to authenticate.
  - You’ll see a welcome message: “Welcome to Hyperliquid! Deposit Arbitrum USDC to get started”.
- Option 2: Sign Up with Email
  - In the “Log in or sign up” prompt, enter your email address (e.g., your@email.com) and click “Submit”.
  - Hyperliquid will send a confirmation email. Open the email and click the link or enter the code in the “Enter confirmation code” field.
- Accept Terms and Conditions
  - After connecting your wallet or verifying your email, you’ll see a “Terms of Use, Privacy Policy, and Cookie Policy” prompt.
  - Check both boxes to agree to the Terms of Use, Privacy Policy, and Cookie Policy.
  - Click “Accept” to proceed. (Clicking “Decline” will prevent you from using the platform.)

Quick Steps to Fund Your Hyperliquid Account with 100 USDC

Note: BITWHALE requires at least 100 USDC in your Hyperliquid account to function properly.

Deposit 100 USDC to Hyperliquid via Arbitrum
- Ensure you have 100 USDC in an Arbitrum-compatible wallet (e.g., MetaMask). If not, buy USDC on a centralized exchange (like Binance or Coinbase), transfer it to your wallet on the Arbitrum network, and add a small amount of ETH for gas fees (~$10 worth).
- Go to app.hyperliquid.xyz/trade, connect your wallet, and click “Deposit.”
- Enter 100 USDC, confirm the transaction in your wallet, and wait for the deposit to process.

Verify Funds in Hyperliquid

Once deposited, your 100 USDC will be available in your Hyperliquid Perpetuals account, ready for trading and API integration with BITWHALE.

Part 1: Generating API Keys on Hyperliquid

Hyperliquid allows you to create API keys for third-party platforms like BITWHALE. Follow these steps to generate them.

Step 1: Access API Keys

- Go to app.hyperliquid.xyz and connect your wallet

- Click on "More" in the menu

- Click on 'API' sub menu item

Step 2:

Create a New API Key

- Enter a name for the API Wallet: BITWHALE Trading

- Click "Generate" and then "Authorize API Wallet"

- On "Days Valid" field click "MAX" (It should fill 180)

- API Wallet Address: IGNORE this address, only use your Email / Metamask Wallet Address

- Private Key (in red color): Store the key securely, it will only be shown once during creation.

- Click "Authorize" and confirm in your Metamask.

Part 2: Linking Hyperliquid API Keys to BITWHALE

Now, connect your Hyperliquid API keys to BITWHALE using the Exchange API Keys tab.

Log In to BITWHALE
- Open bitwhale.com and sign in to your account.
- You’ll land on the BITWHALE dashboard.
Go to Settings
- Locate the top navigation bar and click on “Settings”.
- In the Settings menu, find and select the “Exchange API Keys” box.
Select Hyperliquid and Edit
- In the Exchange API Keys section, you’ll see a list of supported exchanges. Find “Hyperliquid Keys.”
- Click the pencil icon in the bottom-left corner of the Hyperliquid section to edit the fields (as shown in the screenshot).

4. Enter Your API Keys

In the “Access Key” field, paste your Metamask wallet address that is connected to Hyperliquid.
In the “Secret Key” field, paste the Hyperliquid 'Private Key' that you copied earlier.
Double-check for any extra spaces or typos when pasting.

How to find your wallet address for both Metamask and Email Hyperliquid Account?

IMPORTANT - you need to add the wallet address starting with 0x...to BITWHALE

1. Go to https://app.hyperliquid.xyz/trade

2. On the top of the page click on your email address to see your wallet address

On the top of the page click on your wallet address to see your full wallet address starting with 0x...

3. Click copy on the ⎘ Icon where the red arrow is pointing at (Your wallet address starts with 0x....)

4. Copy paste your wallet into the first field in BITWHALE - Settings under "Hyperliquid API Keys" into the first field.

5. Save the Keys

Once both keys are entered, click the “Save All Keys” button.
BITWHALE will attempt to connect to Hyperliquid using the provided keys.

Troubleshooting Tips

Invalid API Key Error: Recheck the keys for typos or spaces. If incorrect, generate a new set on Hyperliquid.
Permission Issues: Ensure “Read” and “Trade” permissions are enabled on the API key.
Insufficient Funds: Hyperliquid requires at least 100 USDC to trade effectively. Verify your balance.
Connection Failed: Confirm your internet connection / VPN or retry after a few minutes. Contact BITWHALE support if needed.