# orderStatus

## POST /info

> Request order status.

```json
{"openapi":"3.1.1","info":{"title":"Hyperliquid API - info/orderStatus","version":"1.0.0"},"tags":[{"name":"orderStatus"}],"servers":[{"url":"https://api.hyperliquid.xyz","description":"Mainnet"},{"url":"https://api.hyperliquid-testnet.xyz","description":"Testnet"}],"paths":{"/info":{"post":{"tags":["orderStatus"],"description":"Request order status.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"description":"Type of request.","enum":["orderStatus"]},"user":{"type":"string","pattern":"^0[xX][0-9a-fA-F]+$","minLength":42,"maxLength":42,"description":"User address."},"oid":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","pattern":"^0[xX][0-9a-fA-F]+$","minLength":34,"maxLength":34}],"description":"Order ID or Client Order ID."}},"required":["type","user","oid"],"description":"Request order status."}}},"required":true},"responses":{"200":{"description":"Order status response.\n- If the order is found, returns detailed order information and its current status.\n- If the order is not found, returns a status of \"unknownOid\".","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"status":{"description":"Indicates that the order was found.","enum":["order"]},"order":{"type":"object","properties":{"order":{"type":"object","properties":{"coin":{"type":"string","description":"Asset symbol."},"side":{"enum":["B","A"],"description":"Order side (\"B\" = Bid/Buy, \"A\" = Ask/Sell)."},"limitPx":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Limit price."},"sz":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Size."},"oid":{"type":"integer","minimum":0,"description":"Order ID."},"timestamp":{"type":"integer","minimum":0,"description":"Timestamp when the order was placed (in ms since epoch)."},"origSz":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Original size at order placement."},"triggerCondition":{"type":"string","description":"Condition for triggering the order."},"isTrigger":{"type":"boolean","description":"Indicates if the order is a trigger order."},"triggerPx":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Trigger price."},"children":{"type":"array","items":{},"description":"Child orders associated with this order."},"isPositionTpsl":{"type":"boolean","description":"Indicates if the order is a position TP/SL order."},"reduceOnly":{"type":"boolean","description":"Indicates whether the order is reduce-only."},"orderType":{"enum":["Market","Limit","Stop Market","Stop Limit","Take Profit Market","Take Profit Limit"],"description":"Order type for market execution.\n- `\"Market\"`: Executes immediately at the market price.\n- `\"Limit\"`: Executes at the specified limit price or better.\n- `\"Stop Market\"`: Activates as a market order when a stop price is reached.\n- `\"Stop Limit\"`: Activates as a limit order when a stop price is reached.\n- `\"Take Profit Market\"`: Executes as a market order when a take profit price is reached.\n- `\"Take Profit Limit\"`: Executes as a limit order when a take profit price is reached. "},"tif":{"anyOf":[{"enum":["Gtc","Ioc","Alo","FrontendMarket","LiquidationMarket"],"nullable":true}],"description":"Time-in-force.\n- `\"Gtc\"`: Remains active until filled or canceled.\n- `\"Ioc\"`: Fills immediately or cancels any unfilled portion.\n- `\"Alo\"`: Adds liquidity only.\n- `\"FrontendMarket\"`: Similar to Ioc, used in Hyperliquid UI.\n- `\"LiquidationMarket\"`: Similar to Ioc, used in Hyperliquid UI."},"cloid":{"anyOf":[{"type":"string","pattern":"^0[xX][0-9a-fA-F]+$","minLength":34,"maxLength":34,"nullable":true}],"description":"Client Order ID."}},"required":["coin","side","limitPx","sz","oid","timestamp","origSz","triggerCondition","isTrigger","triggerPx","children","isPositionTpsl","reduceOnly","orderType","tif","cloid"],"description":"Open order with additional display information."},"status":{"enum":["open","filled","canceled","triggered","rejected","marginCanceled","vaultWithdrawalCanceled","openInterestCapCanceled","selfTradeCanceled","reduceOnlyCanceled","siblingFilledCanceled","delistedCanceled","liquidatedCanceled","scheduledCancel","tickRejected","minTradeNtlRejected","perpMarginRejected","reduceOnlyRejected","badAloPxRejected","iocCancelRejected","badTriggerPxRejected","marketOrderNoLiquidityRejected","positionIncreaseAtOpenInterestCapRejected","positionFlipAtOpenInterestCapRejected","tooAggressiveAtOpenInterestCapRejected","openInterestIncreaseRejected","insufficientSpotBalanceRejected","oracleRejected","perpMaxPositionRejected"],"description":"Order processing status.\n- `\"open\"`: Order active and waiting to be filled.\n- `\"filled\"`: Order fully executed.\n- `\"canceled\"`: Order canceled by the user.\n- `\"triggered\"`: Order triggered and awaiting execution.\n- `\"rejected\"`: Order rejected by the system.\n- `\"marginCanceled\"`: Order canceled due to insufficient margin.\n- `\"vaultWithdrawalCanceled\"`: Canceled due to a user withdrawal from vault.\n- `\"openInterestCapCanceled\"`: Canceled due to order being too aggressive when open interest was at cap.\n- `\"selfTradeCanceled\"`: Canceled due to self-trade prevention.\n- `\"reduceOnlyCanceled\"`: Canceled reduced-only order that does not reduce position.\n- `\"siblingFilledCanceled\"`: Canceled due to sibling ordering being filled.\n- `\"delistedCanceled\"`: Canceled due to asset delisting.\n- `\"liquidatedCanceled\"`: Canceled due to liquidation.\n- `\"scheduledCancel\"`: Canceled due to exceeding scheduled cancel deadline (dead man's switch).\n- `\"tickRejected\"`: Rejected due to invalid tick price.\n- `\"minTradeNtlRejected\"`: Rejected due to order notional below minimum.\n- `\"perpMarginRejected\"`: Rejected due to insufficient margin.\n- `\"reduceOnlyRejected\"`: Rejected due to reduce only.\n- `\"badAloPxRejected\"`: Rejected due to post-only immediate match.\n- `\"iocCancelRejected\"`: Rejected due to IOC not able to match.\n- `\"badTriggerPxRejected\"`: Rejected due to invalid TP/SL price.\n- `\"marketOrderNoLiquidityRejected\"`: Rejected due to lack of liquidity for market order.\n- `\"positionIncreaseAtOpenInterestCapRejected\"`: Rejected due to open interest cap.\n- `\"positionFlipAtOpenInterestCapRejected\"`: Rejected due to open interest cap.\n- `\"tooAggressiveAtOpenInterestCapRejected\"`: Rejected due to price too aggressive at open interest cap.\n- `\"openInterestIncreaseRejected\"`: Rejected due to open interest cap.\n- `\"insufficientSpotBalanceRejected\"`: Rejected due to insufficient spot balance.\n- `\"oracleRejected\"`: Rejected due to price too far from oracle.\n- `\"perpMaxPositionRejected\"`: Rejected due to exceeding margin tier limit at current leverage."},"statusTimestamp":{"type":"integer","minimum":0,"description":"Timestamp when the status was last updated (in ms since epoch)."}},"required":["order","status","statusTimestamp"],"description":"Order status details."}},"required":["status","order"]},{"type":"object","properties":{"status":{"description":"Indicates that the order was not found.","enum":["unknownOid"]}},"required":["status"]}],"description":"Order status response.\n- If the order is found, returns detailed order information and its current status.\n- If the order is not found, returns a status of \"unknownOid\"."}}}},"422":{"description":"Failed to deserialize the JSON body into the target type","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"null"}}}}}}}}}
```
