Exchange Connections · Help Center

Connect Hyperliquid to AstraBit

Link your Hyperliquid account to AstraBit with an API key so the two platforms can communicate securely. You connect your wallet to Hyperliquid, create an API key there, and add that key in AstraBit — no wallet connection to AstraBit needed.

~15 minutes API keys — never custody Perpetual futures

New to Hyperliquid? Sign up with referral code ASTRABIT to become Freemium-eligible — earn credits from trading volume that reduce or cover AstraBit costs. Technical setup guide only; not trading advice.

Good to know

  • Perpetuals only. Spot trading isn’t supported.
  • API keys are valid up to 180 days. After that, create a new one and update AstraBit.
  • Hyperliquid is a DEX. You trade through your own wallet. Centralized vs. decentralized exchanges

Required on Hyperliquid

  • Account type: Manual (Unified Account Mode disabled)
  • Funds in Perps, not Spot
  • Margin: cross or isolated (learn the difference)
  • Main wallet = your Web3 wallet. The wallet you connected to Hyperliquid (e.g., MetaMask) is the address AstraBit needs.

Other settings may show a 0 balance in AstraBit or block trades.

Step-by-Step Setup

Setup Steps

1

Connect Your Wallet to Hyperliquid

  1. On Hyperliquid, click Connect wallet (top-right).
  2. Your wallet (e.g., MetaMask) pops up for app.hyperliquid.xyz.
  3. Select the account you want to use and click Connect.
Your wallet is connected to Hyperliquid.

This is your main wallet. You’ll enter its address in AstraBit in Step 6.

Hyperliquid trading interface showing the HYPE/USDC market with candlestick chart and order book.
The Hyperliquid trading interface
Connect wallet pop-up on Hyperliquid with email, MetaMask, WalletConnect, OKX Wallet, and Coinbase Wallet options.
Connect with MetaMask, WalletConnect, and more
2

Fund Your Account with USDC

  1. Accept Hyperliquid’s Terms of Use, Privacy Policy, and Cookie Policy.
  2. (Optional) In the referral/code field, enter ASTRABIT.
  3. There may be a signature request — no gas fee required for it.
  4. Deposit USDC. This guide uses the Arbitrum network.
  5. A small gas fee (typically under $0.01, paid in ETH on Arbitrum) applies.
  6. Once confirmed, your deposit appears shortly — timing can vary with network congestion and platform activity.
Your Hyperliquid trading account is created and USDC deposited.
Hyperliquid pop-up asking the user to review and accept Terms of Use, Privacy Policy, and Cookie Policy.
Accept the terms to enable trading
Hyperliquid 'Deposit USDC from Arbitrum' pop-up with asset, deposit chain, and amount fields.
Deposit USDC via Arbitrum
Hyperliquid 'Sign Transactions' prompt with the connected wallet asking to confirm a USDC deposit on Arbitrum.
Confirm the deposit in your wallet
3

Set Account Type to Manual

  1. Navigate to your Hyperliquid Portfolio settings.
  2. Click the wheel icon to open additional settings.
  3. Locate the Account Type setting and select Manual.
  4. Toggle Disable Unified Account Mode — this allows you to transfer your USDC.
  5. Save any changes.
Your Hyperliquid account is configured for AstraBit compatibility.

Accounts set to Unified Account or Portfolio Margin may not display balances correctly in AstraBit.

Hyperliquid Unified Account Mode setting.
The Account Type setting in Portfolio
Hyperliquid settings dropdown with the checkbox to disable Unified Account Mode.
Disable Unified Account Mode
4

Move USDC from Spot to Perps

  1. Under the Deposit button on the right side, click the Spot / Perps button.
  2. Enter the amount of USDC you want to transfer.
  3. Click Confirm.
Your funds are available for AstraBit trading strategies.

Funds must sit in Perps. Funds remaining in Spot may not be visible in AstraBit and may prevent trade execution.

Hyperliquid 'Transfer USDC' pop-up moving 550 USDC from Spot to Perps.
Transfer from Spot to Perps
5

Create an API Key on Hyperliquid

  1. Under More at the top, select API.
  2. Click Generate on the right side to create an API wallet address, then click Authorize Wallet.
    • You won’t need this API wallet address later, but it’s required to create the API. It is not your main wallet.
  3. Name your API anything you like.
  4. Copy your Private Key to a safe location.
  5. Set Days Valid to MAX (180 days) or your preferred duration.
    • Once the API expires, you’ll create a new one and update your trading bot.
You have an authorized API wallet and private key, safely stored.
Hyperliquid API page with the 'More' menu expanded and the API option highlighted.
Find API under the More menu
Hyperliquid 'Authorize API Wallet' pop-up with name, address, days valid fields and a private key warning.
Authorize the API wallet and save your private key
6

Add the API in AstraBit & Create Your Bot

  1. In the Nexus API Manager, click Connect New API and select Hyperliquid from the drop-down.
    • Name: anything you like
    • Contract Type: leave default
    • Position Mode: leave default or select Force one way
    • Margin Type: leave default, or select Force Cross or Force Isolated Margin
    • Main Wallet Address: your Web3 wallet address (see below)
    • Private Key: paste the private key generated on Hyperliquid
    • Trusted IPs: if Hyperliquid allows it, add these during API creation
  2. Click Connect.
  3. You’ll see it added to the API Manager dashboard.
  4. It’s now ready to create a crypto trading bot and link to a strategy.

Main Wallet Address = the Web3 wallet address you used to connect to Hyperliquid (e.g., your MetaMask address from Step 1).

Don’t use the API wallet address generated in Step 5 — the connection will show a 0 balance.

Hyperliquid is connected and ready to power your trading bot.
AstraBit 'Connect Hyperliquid API' form with fields for API name, contract type, position mode, margin type, wallet address, private key, and trusted IPs.
The Connect Hyperliquid API form in Nexus
AstraBit Nexus API Manager showing a connected Hyperliquid account with 550 USDC available.
Connected and verified in the API Manager

Troubleshooting

Balance Showing 0?

If AstraBit shows 0 but your funds are visible on Hyperliquid, check these:

1Your account type is set to Manual.
2Your funds are in Perps, not Spot.
3The Main Wallet Address in AstraBit is the Web3 wallet you connected to Hyperliquid.
4Refresh your AstraBit exchange connection.

Still stuck? Contact AstraBit Support or open a ticket on Discord with screenshots of your Portfolio page, Account Type setting, and Perps balance.

FAQ

Hyperliquid Questions

Can I trade spot on Hyperliquid with AstraBit?

No. AstraBit’s Hyperliquid integration supports perpetual futures only. Keep your USDC in Perps — funds left in Spot won’t be visible to AstraBit.

Does Hyperliquid use leverage?

Yes. Perpetual futures are leveraged instruments, and the maximum leverage varies by market. Leverage amplifies both gains and losses, so trading perps — automated or not — carries a significant risk of loss and may not be suitable for everyone. A bot follows rules; it doesn’t guarantee outcomes.

Do Hyperliquid API keys expire?

Yes. Hyperliquid API wallets are valid for up to 180 days. When yours expires, create a new API key on Hyperliquid and update the connection in the Nexus API Manager.

Is Hyperliquid a DEX or a CEX?

Hyperliquid is a decentralized exchange (DEX). You hold your own keys and interact through a Web3 wallet instead of an exchange login. Read more about centralized vs. decentralized exchanges.

Which wallet address goes in “Main Wallet Address”?

The Web3 wallet address (e.g., MetaMask) you used to connect to Hyperliquid — not the API wallet address Hyperliquid generates when you create an API key.

Do I need to connect my wallet to AstraBit?

No. Your wallet only connects to Hyperliquid. AstraBit uses the API private key plus your main wallet address.

Can AstraBit withdraw or move my funds?

No. AstraBit can’t withdraw funds or transfer them between accounts or wallets. It only executes trades through the API permissions you grant.

Your keys, your funds

Cannot withdraw Cannot transfer Trades only, via your API permissions

Connected? Put it to work.

Your Hyperliquid API is live in the Nexus API Manager. Next, create a trading bot and link it to a strategy.

Create Your Trading Bot