How to Connect Hyperliquid to AstraBit

Step 1: Connect Your Wallet to Hyperliquid

1. In Hyperliquid, click Connect wallet (top-right).
2. Your wallet (ex: MetaMask) pops up for app.hyperliquid.xyz.
3. Select the account you want to use.
4. Click Connect.

Result: Your wallet is connected to Hyperliquid.

Step 2: Create Your Hyperliquid Account and Fund It

1. You will need to accept the Terms of Use, Privacy Policy, and Cookie Policy of Hyperliquid
2. (Optional) In the referral/code field, enter: ASTRABIT
3. There may be a signature request, but no gas fee will be required.
4. You will then be asked to deposit USDC. We are using the Arbitrum network here.
5. There will be a small (typically less than $0.01) gas fee required in the form of ETH on Arbitrum.
6. Once confirmed, you deposit will appear shortly. It can be affected by network fees, congestion, platform activity, etc.

Result: Your Hyperliquid trading account is created and USDC deposited.

Step 3: Configure Your Hyperliquid Account Type

Toggle Unified Account Mode

AstraBit requires Hyperliquid accounts to use the Manual account type.

1. Navigate to. your Hyperliquid Portfolio settings
2. Click on the wheel icon to open additional settings
3. Locate the Account Type setting and select Manual
4. Click to toggle “Disable Unified Account Mode”
5. This will allow you to transfer your USDC
6. Save any changes

Result: Your Hyperliquid account is configured for AstraBit compatibility.

Step 4: Transfer USDC from Spot to Perps Account

1. Under the Deposit button on the right side, click the Spot / Perps button.
2. Enter the amount of USDC you want to transfer and click Confirm
3. Enter the amount of USDC you want to transfer.
4. Click Confirm.

Your USDC will be moved into your Perps account and can now be used for trading through AstraBit.

Result: Your funds are available for AstraBit trading strategies.

Step 5: Create an API in Hyperliquid

1. Under ‘More’ at the top, select ‘API’
2. Click on ‘Generate’ on the right hand side to generate an API wallet address. Then click on ‘Authorize Wallet’.
   • NOTE: You will not need this address, but it is required to create the API.
3. Name your API whatever you want to.
4. Copy your Private Key in a safe location.
5. Set ‘Days Valid’ to MAX (180 days) or to the amount of days you want it to be valid.
   • NOTE: Once the API has expired, you will need to create a new one and update your trading bot.

Step 6: Connect the API in AstraBit

1. In the Nexus API Manager, click on ‘Connect New API’ and select Hyperliquid from the drop-down menu.
   
   • Name it whatever you want.
   • Contract Type: leave default
   • Position Mode: leave default or select Force one way
   • Margin Type: leave default or select Force Cross Margin or Force Isolated Margin
   • Main Wallet Address: this is your MetaMask (or whichever) wallet address you used to connect to Hyperliquid
   • Private Key: paste in the private key generated on Hyperliquid
   • Trusted IPs: if Hyperliquid allows it, you can add these IPs during API creation
     
2. Once all of the information is there, click ‘Connect’
3. You will see it succesfully added to the API Manager dashboard
4. It is now ready to be used to create a crypto trading bot.

Troubleshooting: Hyperliquid Balance Showing 0 in AstraBit

If AstraBit displays a balance of 0 even though funds are visible in Hyperliquid:

1. Verify your account type is set to Manual
2. Verify your funds are held in Perps
3. Refresh your AstraBit exchange connection
4. Reconnect the Hyperliquid API if necessary

If the issue persists, contact AstraBit Support and include screenshots of:

• Portfolio page
• Account Type settings
• Balance location (Perps)