Skip to main content
This guide walks you through managing Hyperliquid Sub Accounts on Qubit Alpha and delegating them to fund managers for Copy Trading.

Workflow Overview

  1. Preparation
  2. Create Sub Account
  3. Import to Qubit Alpha
  4. Assign Manager
  5. Daily Management
  6. Permissions & Security

Step 1: Preparation

1.1 Register Qubit Alpha Account

1

Visit Qubit Alpha

2

Connect Wallet

Click “Connect Wallet” to connect your main wallet.
3

Sign Verification

Sign the verification message to confirm wallet ownership.
4

Registration Complete

Complete registration and enter the Qubit Alpha platform.

1.2 Confirm Fund Manager Registration

Fund manager must be a registered Qubit Alpha user
Obtain the fund manager’s wallet address
If the fund manager is not registered, the assignment will fail.

2.1 Prerequisites

Creating a Sub Account requires your main account to have reached 100,000 USDC trading volume.

2.2 Create Sub Account

1

Visit Hyperliquid

2

Connect Wallet

Connect your main wallet.
3

Navigate to Sub Accounts

Find Sub Accounts in the menu.
4

Create Sub Account

Click Create Sub Account, enter a name and confirm creation.

2.3 Create API Key for Sub Account

1

Enter Sub Account

Select the Sub Account you just created.
2

Create API Key

Click API, create a new API Key.
3

Save Private Key

Important: Securely save the private key - it’s only shown once.
Each Sub Account must have its own API Key! While one API Key can technically operate all Sub Accounts, due to Nonce mechanism limitations, one API Key cannot operate multiple Sub Accounts simultaneously, otherwise trading conflicts will occur. Qubit Alpha requires: One Sub Account = One dedicated API Key.

2.4 Set Up Builder Fee

1

Visit Settings Page

Go to Qubit Alpha Builder Fee Settings page.
2

Connect Wallet

Connect your main wallet.
3

Complete Authorization

Follow the on-page instructions to complete Builder Fee authorization.
If Builder Fee is not set, import validation will fail.

Step 3: Import Sub Account to Qubit Alpha

3.1 Access Add Page

1

Login to Qubit Alpha

Login to Qubit Alpha with your main wallet.
2

Go to Sub Account Management

Navigate to Sub Account Management.
3

Add Sub Account

Click Add Sub Account.

3.2 Select Sub Account

Qubit Alpha will automatically fetch your Sub Account list. Select the Sub Account you want to import.

3.3 Enter API Key

1

Enter Private Key

Enter the API private key you created on Hyperliquid.
2

Set Display Name

Set a display name for this account.

3.4 Confirm Import

Qubit Alpha will verify:
  • API Key validity
  • Builder Fee setup status
Once verified, import is complete.

Step 4: Assign to Fund Manager

1

Go to Sub Account Management

Navigate to Sub Account Management in Qubit Alpha.
2

Select Sub Account

Choose the Sub Account to assign.
3

Assign Fund Manager

Click Assign Fund Manager.
4

Enter Address

Enter the fund manager’s wallet address.
5

Confirm Assignment

Confirm the assignment.
If the fund manager hasn’t registered on Qubit Alpha, assignment will fail with “Address not registered” message.

Step 5: Daily Management

View Account Status

Go to Sub Account Management to view all accounts, including positions, P&L, and Bot running status.

Stop Bot

1

Select Account

Select the Sub Account.
2

Stop Bot

Click Stop Bot.
3

Complete

Bot will stop executing new trades.

Remove Fund Manager Assignment

1

Select Account

Select the Sub Account.
2

Remove Assignment

Click Remove Assignment.
3

Confirm

After confirmation, fund manager loses management permissions and associated Bots will automatically stop.

Emergency Revocation (On-chain)

1

Visit Hyperliquid

2

Enter Sub Account

Navigate to the corresponding Sub Account.
3

Revoke API

Delete/revoke the API Key.

Permissions & Security

API Key Technical Limitations

LimitationDescription
ScopeAPI Key can sign operations for main account and all Sub Accounts
Nonce MechanismEach API Key uses an independent Nonce sequence
Concurrency LimitOne API Key cannot operate multiple Sub Accounts simultaneously (Nonce conflict)
Qubit Alpha RequirementEach Sub Account must use a dedicated API Key

API Key Permissions

PermissionStatus
Trading (open/close orders)✅ Allowed
Leverage Adjustment✅ Allowed
Internal Transfer❌ Not Allowed
Withdrawal❌ Not Allowed

Fund Manager Permissions

OperationPermission
Configure and start/stop Copy Trade Bot✅ Allowed
View positions and P&L✅ Allowed
Withdraw or transfer funds❌ Not Allowed
Modify account settings❌ Not Allowed
API Key can only perform trading operations, cannot transfer or withdraw funds. API Key leakage will not result in funds being transferred away.

Fund Manager Permissions

After assignment, fund managers can:
OperationPermission
Configure and start/stop Copy Trade Bot✅ Allowed
View positions and P&L✅ Allowed
Withdraw or transfer funds❌ Not Allowed
Modify account settings❌ Not Allowed
Assign to others❌ Not Allowed

Security Recommendations

  1. Safely store API private key - never share with anyone
  2. Use dedicated API Key for each Sub Account
  3. Only assign to trusted fund managers
  4. Regularly check trading records - stop Bot immediately if anomalies detected
  5. If API leak suspected - immediately revoke on Hyperliquid

Risk Disclosure

ScenarioRiskYour Control
Fund manager strategy lossCapital reductionStop Bot, remove assignment
High leverage operationLiquidation riskMonitor positions, intervene promptly
API Key leakMalicious tradingRevoke API on Hyperliquid
Extreme market conditionsSignificant lossesSet stop-loss in advance

FAQ

Main account must reach 100,000 USDC trading volume.
Please set Builder Fee on Qubit Alpha first.
Confirm you’re using the main wallet that created the Sub Account.
Fund manager needs to register a Qubit Alpha account first.
No, API Key has no withdrawal permissions.
Nonce mechanism limitation - sharing causes trading conflicts.

Next Steps

Asset Management

Learn how to manage deposits and withdrawals.

Dashboard

Understand your portfolio and performance metrics.