> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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).
1 per call
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](/docs/pricing-calculator?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Forder-status).
* 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
```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer
Content-Type: application/json
```
## Request
Always `"orderStatus"`.
The account address in 42-character hex format, e.g. `"0x0000000000000000000000000000000000000000"`.
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
```bash cURL theme={null}
curl -X POST https://hypercore.goldrushdata.com/info \
-H "Authorization: Bearer $GOLDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "orderStatus",
"user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
"oid": 513957677284
}'
```
```typescript TypeScript theme={null}
const response = await fetch("https://hypercore.goldrushdata.com/info", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "orderStatus",
user: "0x31ca8395cf837de08b24da3f660e77761dfb974b",
oid: 513957677284,
}),
});
const result = await response.json();
if (result.status === "order") {
console.log(result.order.status, result.order.order.coin, result.order.order.oid);
} else {
console.log("not found:", result.status); // "unknownOid"
}
```
```python Python theme={null}
import os, requests
response = requests.post(
"https://hypercore.goldrushdata.com/info",
headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
json={"type": "orderStatus", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b", "oid": 513957677284},
)
result = response.json()
if result["status"] == "order":
print(result["order"]["status"], result["order"]["order"]["coin"])
else:
print("not found:", result["status"])
```
## 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`.
```json theme={null}
{
"status": "order",
"order": {
"order": {
"coin": "POPCAT",
"side": "A",
"limitPx": "0.043668",
"sz": "16812.0",
"oid": 513957677284,
"timestamp": 1786384269962,
"triggerCondition": "N/A",
"isTrigger": false,
"triggerPx": "0.0",
"children": [],
"isPositionTpsl": false,
"reduceOnly": false,
"orderType": "Limit",
"origSz": "16812.0",
"tif": "Alo",
"cloid": null
},
"status": "canceled",
"statusTimestamp": 1786384274789
}
}
```
Not found:
```json theme={null}
{ "status": "unknownOid" }
```
### Field descriptions
`limitPx`, `sz`, `origSz`, and `triggerPx` are returned as **decimal strings**, preserving upstream precision. Do not parse them as floats.
`"order"` when the order is found, `"unknownOid"` when there is no such order for this user.
Present only when `status` is `"order"`.
The order itself.
Asset symbol.
`"B"` = bid (buy), `"A"` = ask (sell).
Limit price (decimal string).
Remaining size (decimal string).
Original size (decimal string).
Order id.
Client order id (hex) if supplied, else `null`.
Order creation time (ms since epoch).
e.g. `"Limit"`, `"Stop Market"`.
Time-in-force, e.g. `"Alo"`, `"Gtc"`, `"Ioc"`.
Whether the order is reduce-only.
Whether it is a trigger order.
Trigger condition, or `"N/A"`.
Trigger price (decimal string).
Whether it is a position-level TP/SL.
Child orders attached to this order.
The order's current or terminal status. Hyperliquid defines many values; observed examples include `"open"`, `"filled"`, `"canceled"`, `"selfTradeCanceled"`, and `"iocCancelRejected"`.
Millisecond timestamp when the status took effect.
## Related endpoints
A user's recent orders (open + finalized), up to 2000.
A user's currently-resting open orders.