Skip to main content
POST
orderStatus | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with 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).
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "orderStatus", "user": "0x...", "oid": ...}.
  • oid accepts 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"} (no order field).
  • To fetch many orders at once, use historicalOrders instead.
Returns the status of one order together with the order itself. Use it to poll a specific order you placed - by its exchange 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.
Not found:

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".

historicalOrders

A user’s recent orders (open + finalized), up to 2000.

openOrders

A user’s currently-resting open orders.