Retrieve the current status of an order using either the order ID (oid) or client order ID (cloid). This endpoint provides detailed information about order state, execution status, and timestamps.
info
endpoint with type: "orderStatus"
retrieves the current status and details of a specific order on the Hyperliquid exchange. This endpoint accepts either an order ID (oid) or client order ID (cloid) to query order information, making it essential for order tracking and management.
type
(string, required) — The request type. Must be "orderStatus"
to query order status.user
(string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.oid
(integer or string, required) — Either u64 representing the order id or 16-byte hex string representing the client order id.status
— Always “order” when order information is availableorder
— Object containing the order wrapper with order details and statusorder
— Object containing the actual order detailsstatus
— Current order status (see status values below)statusTimestamp
— Timestamp when the status was last updatedorder
object):
coin
— Asset identifier (simple names like “BTC”, “ETH” for perpetuals; spot format like “@107” for spot trades)side
— Order side: “A” for Ask/Sell, “B” for Bid/BuylimitPx
— Limit price as a string for precisionsz
— Current order size (remaining quantity)oid
— Order IDtimestamp
— Order creation timestamp in millisecondstriggerCondition
— Trigger condition for conditional ordersisTrigger
— Boolean indicating if this is a trigger ordertriggerPx
— Trigger price for conditional orderschildren
— Array of child orders (for TP/SL orders)isPositionTpsl
— Boolean indicating if this is a position-level TP/SL orderreduceOnly
— Boolean indicating if this is a reduce-only orderorderType
— Order type (e.g., “Market”, “Limit”)origSz
— Original order sizetif
— Time in force (e.g., “FrontendMarket”, “Gtc”, “Ioc”)cloid
— Client order ID if provided (null if not set)status
— “unknownOid” indicating the order was not foundstatus
field in the order response can have the following values:
open
— Order placed successfully and waiting for executiontriggered
— Trigger order has been triggered and converted to a regular orderfilled
— Order has been completely executedcanceled
— Order canceled by usermarginCanceled
— Canceled due to insufficient margin to fillvaultWithdrawalCanceled
— Vaults only. Canceled due to user withdrawal from vaultopenInterestCapCanceled
— Canceled due to order being too aggressive when open interest was at capselfTradeCanceled
— Canceled due to self-trade preventionreduceOnlyCanceled
— Canceled reduce-only order that does not reduce positionsiblingFilledCanceled
— TP/SL only. Canceled due to sibling order being filleddelistedCanceled
— Canceled due to asset delistingliquidatedCanceled
— Canceled due to liquidationscheduledCancel
— API only. Canceled due to exceeding scheduled cancel deadline (dead man’s switch)rejected
— Order rejected at time of placementtickRejected
— Rejected due to invalid tick priceminTradeNtlRejected
— Rejected due to order notional below minimumperpMarginRejected
— Rejected due to insufficient marginreduceOnlyRejected
— Rejected due to reduce only constraintsbadAloPxRejected
— Rejected due to post-only immediate matchiocCancelRejected
— Rejected due to IOC not able to matchbadTriggerPxRejected
— Rejected due to invalid TP/SL pricemarketOrderNoLiquidityRejected
— Rejected due to lack of liquidity for market orderpositionIncreaseAtOpenInterestCapRejected
— Rejected due to open interest cappositionFlipAtOpenInterestCapRejected
— Rejected due to open interest captooAggressiveAtOpenInterestCapRejected
— Rejected due to price too aggressive at open interest capopenInterestIncreaseRejected
— Rejected due to open interest capinsufficientSpotBalanceRejected
— Rejected due to insufficient spot balanceoracleRejected
— Rejected due to price too far from oracleperpMaxPositionRejected
— Rejected due to exceeding margin tier limit at current leverageinfo
endpoint with type: "orderStatus"
is essential for applications that need to:
Successful response
The response is of type object
.