orderStatus | Hyperliquid Info API
Info API
orderStatus | Hyperliquid Info API
Hyperliquid orderStatus: look up the status of a single order for a user by order id (oid) or client order id (cloid).
POST
orderStatus | Hyperliquid Info API
Credit Cost
1 per call
Processing
Realtime
type: "orderStatus" is used to look up the status of a single order for a user, by order id (oid) or client order id (cloid).
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "orderStatus", "user": "0x...", "oid": ...}. oidaccepts either a numeric order id or a client order id (cloid, a hex string).- If the order is not found for that user, the response is
{"status": "unknownOid"}(noorderfield). - To fetch many orders at once, use
historicalOrdersinstead.
oid or the cloid you supplied - without pulling the user’s whole order history.
Endpoint
Request
string
default:"orderStatus"
required
Always
"orderStatus".string
required
The account address in 42-character hex format, e.g.
"0x0000000000000000000000000000000000000000".int | string
required
The order identifier. Pass the numeric order id (e.g.
513957677284) or a client order id (cloid) as a hex string (e.g. "0x...").Example
Response
When the order is found,status is "order" and order contains the order plus its status. When it is not, status is "unknownOid" and there is no order.
Field descriptions
limitPx, sz, origSz, and triggerPx are returned as decimal strings, preserving upstream precision. Do not parse them as floats.string
"order" when the order is found, "unknownOid" when there is no such order for this user.object
Present only when
status is "order".Related endpoints
historicalOrders
A user’s recent orders (open + finalized), up to 2000.
openOrders
A user’s currently-resting open orders.