---
title: "Get order status"
method: POST
path: "/api/v1/developer/trading/hyperliquid/info/order/status"
---

# Get order status

`POST /api/v1/developer/trading/hyperliquid/info/order/status`

Retrieve the status of a specific order by order ID or client order ID

## Request body

- OrderStatusRequest
  - `type` 'orderStatus', required — Request type - must be 'orderStatus'
  - `user` string, required — User's wallet address (hex string)
  - `oid` union, required — Order ID - can be either numeric order ID or string client order ID
    - string — Client order ID (string)
    - integer — Order ID (integer)

## Response `200`

Order status retrieved successfully

- union
  - HyperliquidGetOrderStatusResponse
    - `order` HyperliquidOrder
      - `coin` string, nullable — Trading pair symbol
      - `side` string, nullable — Order side (A for long/buy, B for short/sell)
      - `limitPx` string, nullable — Limit price
      - `sz` string, nullable — Order size
      - `oid` integer, nullable — Order ID
      - `timestamp` integer, nullable — Order creation timestamp
      - `triggerCondition` string, nullable — Trigger condition for conditional orders
      - `isTrigger` boolean, nullable — Whether this is a trigger order
      - `triggerPx` string, nullable — Trigger price for conditional orders
      - `children` unknown
      - `isPositionTpsl` boolean, nullable — Whether this is a position take-profit/stop-loss order
      - `reduceOnly` boolean, nullable — Whether this is a reduce-only order
      - `orderType` string, nullable — Order type
      - `origSz` string, nullable — Original order size
      - `tif` string, nullable — Time in force
      - `cloid` string, nullable — Client order ID
    - `status` string, nullable — Order status
    - `statusTimestamp` integer, nullable — Timestamp when status was last updated
  - object
    - `status` 'unknownOid'

## Other responses

- `400` — Bad request - Invalid type or missing orderId
- `500` — Internal server error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)