Common Hyperliquid Error Messages Explained
When trading on Hyperliquid docs, you may occasionally run into short error messages that do not explain much on their own. For new users, it can be hard to tell whether the issue is with margin, order settings, the market, the wallet, or the network. Source: OneKey GitHub.
This guide breaks down common Hyperliquid error messages, what they usually mean, and practical steps you can take to resolve them.
Key comparison table
Error Types at a Glance
Most Hyperliquid errors fall into four broad categories:
- Account status errors: insufficient margin, account not initialized, leverage limits
- Order parameter errors: price out of range, invalid size, unsupported order settings
- Market and contract errors: paused markets, position limits, open order limits
- Connection and signature errors: wallet signature failures, disconnected wallet, timeout issues
Account Status Errors
"Insufficient margin"
What it means: Your available margin is not enough to cover the initial margin required for the order you are trying to place.
How to fix it:
- Reduce the order size
- Lower the leverage used for the position
- Deposit more USDC into your account
- Close part of an existing position to free up margin
It is also worth reviewing how margin is calculated on Hyperliquid. Understanding the difference between cross margin and isolated margin can help you avoid this error before submitting an order.
"Account not found"
What it means: The wallet address does not yet have an initialized Hyperliquid account. This usually happens when using Hyperliquid for the first time.
How to fix it: Complete the initial deposit and sign the required initialization transaction. Also make sure you are using the correct wallet address.
"Leverage too high"
What it means: The leverage you selected is higher than the maximum allowed for that market.
How to fix it: Check the maximum leverage supported by the trading pair and lower your leverage to an allowed level before placing the order.
Order Parameter Errors
"Price out of range"
What it means: The limit price you entered is too far away from the current mark price and is outside the protocol’s allowed price band.
How to fix it: Move your limit price closer to the current market price. Hyperliquid applies price deviation limits to reduce the risk of extreme or accidental orders.
"Size too small"
What it means: The order size is below the minimum trade size for that market.
How to fix it: Increase the order size, or choose a market with a smaller minimum order size.
"Invalid order type"
What it means: The order parameters are not valid for the current market or order type. For example, a specific order type may not be supported in the way you are trying to use it.
How to fix it: Review the order settings and confirm that the selected order type is compatible with the current market state.
Market and Contract Errors
"Market is paused"
What it means: The market is temporarily paused. This may happen due to protocol maintenance, abnormal price conditions, circuit-breaker-style protections, or other risk controls.
How to fix it: Wait for the market to resume. Check Hyperliquid’s official announcements for current status updates. Existing positions typically remain in place while a market is paused.
"Position size limit exceeded"
What it means: Your account has reached the protocol-defined position size limit for that market.
How to fix it: Reduce the size of the new order, or close part of your existing position before adding more exposure. Position limits are designed to reduce the risk of market manipulation by a single account.
"Max open orders exceeded"
What it means: Your account has reached the maximum number of open orders, either for one market or across the account.
How to fix it: Cancel unnecessary open orders, then submit the new order again.
Connection and Signature Errors
"Signature invalid"
What it means: The wallet signature failed verification. Common causes include an expired signing request, switching wallet accounts, or incomplete signature data due to a network issue.
How to fix it:
- Refresh the page and submit the signing request again
- Disconnect and reconnect your wallet
- Check that the active wallet account matches the address connected to Hyperliquid
When using OneKey Wallet, each signing request is displayed clearly on the device so you can review what you are signing. EIP-712 structured signatures, where supported, make signature data easier to read than raw hashes and help users verify transaction details before approving.
"Wallet not connected"
What it means: The Hyperliquid front end cannot detect an active wallet connection.
How to fix it: Reconnect your wallet from the page. If you are using WalletConnect docs with a mobile wallet, check whether the WalletConnect session is still active and reconnect if needed.
"Transaction rejected"
What it means: The signing request was manually rejected in the wallet, or the request timed out before approval.
How to fix it: Submit the action again and approve the wallet signing request promptly after it appears.
Funding-Related Errors
"Withdrawal amount exceeds available balance"
What it means: The withdrawal amount is higher than your available balance, or part of your balance is being used as margin for open positions or unsettled PnL.
How to fix it: Check unrealized PnL, margin usage, and your available withdrawal balance before trying again. The balance panel in the Hyperliquid App can help you understand which funds are available.
Quick Troubleshooting Checklist
To reduce repeated errors when trading on Hyperliquid:
- Check your available margin and leverage settings before placing orders
- Make sure your order size and limit price meet the market’s requirements
- Use a stable browser session to avoid wallet signing timeouts
- Connect to Hyperliquid through OneKey Perps for a clearer wallet signing flow with OneKey Wallet
- Keep an eye on Hyperliquid’s official channels when you encounter unknown or market-wide errors
OneKey Perps provides a practical workflow for accessing Hyperliquid perpetuals while keeping wallet signing transparent and easy to verify. If you trade perps regularly, consider downloading OneKey and using OneKey Perps as your entry point.
FAQ
Q1: Will my funds be lost after an error message?
Usually, no. Most error messages mean the action was not executed, so funds remain in your account. However, liquidation is different: if a position is liquidated, some or all of the margin may be lost as part of the protocol’s normal risk management process. Liquidation is not simply an error message.
Q2: What should I do if the same error keeps appearing?
Record the exact error message and the steps that triggered it. Then check Hyperliquid’s official community channels or contact support through the Hyperliquid App help entry.
Q3: If a withdrawal fails, are my funds locked?
Usually not. A failed withdrawal generally means the action was not submitted or did not complete, and the funds remain in the account. Wait a short time and try again, or contact official support if the problem persists.
Q4: How can I tell whether it is my mistake or a protocol bug?
Check whether the action was recorded on-chain. If there is no record, it is often a client-side or wallet-side issue. If there is an on-chain record but the result looks abnormal, it may need to be reported to Hyperliquid support or the official community.
Q5: Is MetaMask or OneKey Wallet more stable for Hyperliquid?
Both are supported. OneKey is fully open source, and its signing interface is designed to make transaction review clear. For users who care about auditability and transparent signing, OneKey can provide additional confidence.
Conclusion
Hyperliquid error messages can look vague at first, but most of them have clear causes and straightforward fixes. By identifying whether the issue is related to margin, order parameters, market status, or wallet signing, you can usually get back to normal trading quickly.
If you want a clear and practical setup for trading Hyperliquid perpetuals, download OneKey and access the market through OneKey Perps. Always review each order and signing request carefully before confirming.
Risk warning: This article is for informational purposes only and does not constitute investment, legal, or financial advice. Crypto asset trading is high risk and may involve market volatility, technical failures, liquidation risk, and regulatory uncertainty. Understand the risks before trading.
