HyperliquidHyperliquid Trade Inputs and Execution Confirmation
Updated on
Hyperliquid trade confirmation starts with the selected market, account, and execution settings and ends with matching fill records. Before submission, check the direction, quantity, available balance or margin, and price conditions. Afterward, distinguish an open order from an executed trade, then compare the recorded fills with the resulting token balance or perpetual position.
A successful submission message does not necessarily mean the entire requested quantity traded. The useful distinction is between what the order authorized and what matching actually executed, especially when the interface stops updating or reports an incomplete result.
Bottom line: An order response confirms its reported status; individual fills establish the executed quantity, price, and charges.
Spot trades and perpetual adjustments
Spot and perpetual orders require different starting balances and produce different account changes, even when their displayed names resemble each other.
Spot balance changes
A spot purchase exchanges the quote asset for the selected token; a sale exchanges that token for the quote asset. Check the market identity and the asset that the order will spend. A token balance elsewhere in the account does not automatically establish sufficient spendable balance for that specific trade. The relevant input is the available balance under the account’s active configuration.
Perpetual position changes
A perpetual order changes contract exposure when it fills, so its direction must make sense relative to the existing position. Buying can increase a long position or reduce a short position. Selling can increase a short position or reduce a long position. When the intended action is only a reduction, the reduce-only setting constrains the order accordingly. Check the existing position before interpreting the order’s direction.
Account balance and margin readiness
The account selected for trading determines which balances, open orders, and positions belong in the pre-submission check.
The selected account
A master account and a subaccount have distinct account addresses. Confirm that the account showing the available funds is also the account receiving the order. Keep its existing orders visible during review, since they may represent commitments that the new order form does not explain. For an automated submission, retain the target account alongside the request so later records have an unambiguous owner.
Collateral and margin settings
Perpetual trading also requires the applicable margin mode and leverage setting. Cross margin shares collateral within the scope permitted by the account configuration; isolated margin assigns collateral to an individual position. Account abstraction affects how spot balances and collateral interact. Total account value therefore does not, by itself, establish that a proposed order meets its margin requirement.
Higher leverage lowers the initial margin requirement for the same exposure. It does not reduce that exposure’s sensitivity to price movements.
Size units and valid price increments
The quantity field must describe the intended exposure in the units that the order form actually accepts.
Distinguish token or contract quantity from an estimated quote value. Their relationship changes with price, so a value display and a quantity display do not describe interchangeable inputs. Review both when the interface provides them. Also check whether a position reduction covers the intended fraction or the entire position; an old quantity may no longer match a position that other orders have changed.
Price and size must satisfy the selected market’s permitted increments. Tick size governs valid prices, while lot size governs valid quantities. Extra decimal places can make an otherwise sensible order invalid. If the interface rounds an entry, review the resulting value before submission rather than assuming it retained the original amount.
Price limits and available liquidity
The order book shows available buying and selling interest, while execution settings determine which of those prices an order may accept.
A limit price bounds the execution price: a buy limit specifies the highest acceptable price, and a sell limit specifies the lowest. It does not establish that enough opposing quantity exists. A market order seeks immediate execution against available liquidity, so the displayed reference price cannot establish its final average fill price. Inspect any applicable slippage setting as part of the submitted instructions.
Order types also differ in what happens to unmatched quantity. A good-til-canceled order can leave a remainder resting, while immediate-or-cancel removes the unfilled remainder. That choice belongs in the review whenever an outstanding order would change the intended result. A snapshot of liquidity cannot reserve the displayed quantity while the user considers the order.
What becomes binding when I submit an order?
Submitting an authorized order permits execution under its specified conditions once the trading system accepts and processes it.
The final review belongs before that submission, whether the interface presents a confirmation screen or submits directly. Compare the selected account, market, direction, size, price conditions, and reduction setting with the intended action. For an API submission, those instructions reside in the signed request. A confirmation screen is useful only when its displayed values match the request that follows.
A cancellation request cannot undo a completed fill.
Submission responses and outstanding quantity
An order response can report a resting order, an immediate fill, or an error, and each result requires a different interpretation.
A resting response means that an order remains on the book; it does not establish full execution. A fill response reports executed size and average price. An error identifies a failed instruction, although batched requests need attention to the result for each order. Preserve the order identifier whenever the response supplies one so subsequent status checks refer to the same instruction.
Outstanding quantity remains relevant after a partial fill. The original requested size, executed quantity, and remaining quantity answer different questions. An order disappearing from the open-order display does not alone distinguish a completed fill from cancellation or rejection. Historical status and trade records resolve that distinction.
Which records confirm that the order executed?
Fill records confirm executed trades, while order status establishes whether any quantity remains outstanding or the order has ended.
Execution details
Each fill identifies its market, side, quantity, execution price, and time. Match the order identifier before combining fills. Multiple matches can complete one order at different prices, so a single row may represent only part of the execution. To calculate the quantity-weighted average price, multiply each fill’s price by its quantity, add those products, and divide by the total executed quantity.
Resulting account entries
Spot confirmation concerns the resulting asset balances; perpetual confirmation concerns position size and direction as well as collateral. Compare records from the same account and a consistent time window. Other orders, transfers, and position changes can otherwise make a correct fill appear inconsistent with the latest display. Account state provides the context for the trade record, rather than replacing it.
Trading charges and balance differences
Execution price and trading charges explain different parts of the balance change, so review both before treating a difference as an error.
Fee schedules differ between spot and perpetual trading, and the applicable tier affects the charge. Maker and taker treatment also matters. A limit order that immediately matches available liquidity can take liquidity, so its name alone does not establish a maker fee. Use the charge recorded for the execution when reconciling that trade.
Funding rates concern continuing perpetual exposure and can produce separate account entries. Keep funding payments distinct from the fee for an individual fill. Likewise, a position’s unrealized profit or loss changes with its valuation price after execution. A later account-value change does not necessarily mean that the original execution price changed.
How should I handle a missing submission response?
A missing submission response requires checking the original order’s status before placing another order for the same intended trade.
Consider a spot purchase where the chosen account has sufficient available quote balance and the purchase must respect a maximum price. A limit order fits that price constraint.
- Confirm the selected spot market and check that the account has sufficient available balance in the asset the purchase will spend.
- Check that the buy quantity and limit price express the intended purchase and satisfy the market’s increments.
- Choose whether unmatched quantity may remain open, then review the final instructions before submission.
- If the response arrives, match its order identifier to the recorded fills and any remaining open quantity.
- If the response is missing, inspect recent orders and fills for that account before deciding whether any replacement is necessary.
When the purchase fills completely, the fills account for the requested quantity, the balances reflect those trades and charges, and no remainder stays open. With a missing response, the next action is status retrieval. Resubmitting immediately risks creating an additional purchase if the original instruction already executed.
If a remainder is still open, it remains part of the intended purchase until it fills or cancellation succeeds. An unresolved status leaves the purchase unresolved; it does not establish that nothing happened.
Attached exits after a position change
Attached take-profit and stop-loss orders need their own status check. They are placed only after the parent fills completely or partially fills and then is canceled for insufficient margin.
Manually canceling a partially filled parent order also cancels its attached take-profit and stop-loss orders.
The filled portion can therefore leave a position without those attached exits. A cancellation caused by insufficient margin follows a different rule: after a partial parent fill, the attached orders are placed. The cancellation reason matters. A generic canceled label cannot establish the condition of every related instruction.
Position-level exits also require attention to sizing. An exit configured for the entire position attempts to close the position at trigger time, while a specifically sized exit retains its fixed quantity. After changing exposure, compare active exit quantities with the resulting position. An entry fill proves that exposure exists; it does not establish that the desired exit orders cover it.
Limits of the final confirmation
A completed trade record establishes a past execution, while an open perpetual position continues to face changing margin requirements and market prices.
Keep the execution record separate from the ongoing position decision. Leverage, collateral, and maintenance margin still govern liquidation exposure after the order finishes. A successful trade also does not establish that the resulting balance is entirely withdrawable, because other account obligations may constrain transfers. The final confirmation should identify the executed quantity and any outstanding instructions without implying that all subsequent account activity is settled.
Hyperliquid: frequently asked questions
Does an HTTP success response prove that every order in a batch traded?
An HTTP success response does not prove that every submitted order traded. The response can contain individual order errors even when its outer status reports success. Inspect each order result. Some validation failures reject the whole batch with one error, so the number of returned errors does not always match the number of requested orders.
Can closing the browser cancel an open Hyperliquid order?
Closing the browser does not cancel an order that already rests on the order book. Its execution conditions continue to apply until it fills or a cancellation takes effect. Browser visibility and order status are separate, so reopening the interface requires checking the account’s outstanding orders and recent fills.
When will a post-only order fail to rest on the book?
A post-only order fails to rest when its price would immediately match existing liquidity. That behavior preserves its instruction to add liquidity rather than take it. A changing best bid or offer can affect the outcome between reviewing the order and submitting it, even when the chosen price looked suitable earlier.
Which price activates a take-profit or stop-loss order?
The mark price activates take-profit and stop-loss orders. A last-trade display crossing the selected level does not by itself establish that the trigger condition occurred. Activation and execution are separate events: the resulting market or limit order must still interact with available liquidity under its execution conditions.
What does a missing-order error mean during cancellation?
A missing-order cancellation error can mean that the order never existed, already completed, or was already canceled. The error alone does not distinguish those outcomes. Check the original submission result and subsequent order history; any completed fills remain effective even though there is no longer an open order to cancel.
How can position entry price differ from the last execution price?
A position’s displayed entry price can combine earlier exposure with later additions, whereas the last execution price describes one fill. Increasing a position updates its average entry price using the existing position and the new execution. Use the relevant fill records to assess the latest order instead of treating the position average as that order’s price.