Order Status

Query individual order status and details

Query the status and details of a specific order.

The examples on this page use Hyperliquid (provider: 'hyperliquid'). Replace the provider value with any supported provider from getProviders().

import { getOrder } from '@lifi/perps-sdk';

const order = await getOrder(client, {
  provider: 'hyperliquid',
  address: userAddress,
  id: '12345678',
});

console.log(order.status);       // 'FILLED'
console.log(order.averagePrice); // '95050.00'
console.log(order.filledSize);   // '0.1'
console.log(order.statusReason); // venue text for REJECTED or CANCELLED, when given

PerpsClient.getOrder takes the same parameters and returns the same Order.

Order Status Values

Status	Description
PENDING	A placement TP/SL leg waiting for its parent order to fill
ACCEPTED	The venue accepted the order and has not yet placed it on the book. It waits on no parent order
OPEN	Live on the book, or an armed trigger waiting for its trigger price
PARTIALLY_FILLED	Open with a positive filled size
FILLED	Terminal: the order filled
CANCELLED	Terminal: the order was cancelled. statusReason carries the venue reason
REJECTED	Terminal: the order was rejected. statusReason carries the venue reason
EXPIRED	Terminal: the order expired
TRIGGERED	The trigger price was hit and the order went live. It has not necessarily executed

The terminal statuses are FILLED, CANCELLED, REJECTED and EXPIRED. getOrders returns OPEN, PENDING, ACCEPTED, PARTIALLY_FILLED and TRIGGERED orders by default; pass statuses to read others. isActiveOrderStatus(status) tests membership in that default set.

Acceptance vs execution

success: true on a placeOrder result means the venue accepted the order for submission. It can still end up REJECTED, CANCELLED or EXPIRED later, for example a post-only order that would cross, or a margin or reduce-only check that fails after acceptance. Watch the order after placing it:

• Subscribe to orderUpdates and react to terminal statuses. Its frames carry orders: Order[] and terminated: string[].
• Fall back to getOrder with the orderId from the placement result while the stream has not delivered the order yet.
• Show statusReason to the user on REJECTED and CANCELLED.

On Lighter, id also accepts a client_order_index-prefixed form that resolves an order before the venue assigns its order_index — see Lighter / Trading.

Reference: Account — Orders (account reads are served by the SDK, not as HTTP endpoints)