Retrieve the most recent historical orders for a specific user. Returns at most 2000 most recent historical orders with their current status and detailed order information.
info
endpoint with type: "historicalOrders"
retrieves a user’s historical orders on the Hyperliquid exchange. This endpoint provides comprehensive order history including detailed order information and final status for each order, making it essential for trade analysis, reporting, and order management.
type
(string, required) — The request type. Must be "historicalOrders"
to retrieve historical orders.user
(string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.order
— Detailed order information objectstatus
— Final order statusstatusTimestamp
— Timestamp when the status was last updatedorder
object contains comprehensive order information:
Basic order data:
coin
— Asset identifier (simple names like “BTC”, “ETH” for perpetuals; spot format like “@107” for spot trades)side
— Order side: “A” for Ask/Sell, “B” for Bid/BuylimitPx
— Limit price as a string for precisionsz
— Current order size (remaining quantity)origSz
— Original order size when placedoid
— Order ID (unique identifier)timestamp
— Order creation timestamp in millisecondsorderType
— Order type (e.g., “Market”, “Limit”, “Stop”, “StopLimit”)tif
— Time in force (e.g., “FrontendMarket”, “Gtc”, “Ioc”, “Fok”)reduceOnly
— Boolean indicating if this is a reduce-only ordercloid
— Client order ID if provided (null if not set)isTrigger
— Boolean indicating if this is a trigger ordertriggerCondition
— Trigger condition for conditional orderstriggerPx
— Trigger price for conditional ordersisPositionTpsl
— Boolean indicating if this is a position-level TP/SL orderchildren
— Array of child orders (for TP/SL orders)status
field indicates the final state of each order:
Completed states:
filled
— Order completely executedtriggered
— Trigger order activated and convertedcanceled
— Order canceled by usermarginCanceled
— Canceled due to insufficient marginvaultWithdrawalCanceled
— Canceled due to vault withdrawalopenInterestCapCanceled
— Canceled due to open interest capselfTradeCanceled
— Canceled due to self-trade preventionreduceOnlyCanceled
— Canceled reduce-only order that wouldn’t reduce positionsiblingFilledCanceled
— TP/SL canceled due to sibling order executiondelistedCanceled
— Canceled due to asset delistingliquidatedCanceled
— Canceled due to liquidationscheduledCancel
— Canceled due to scheduled cancel (dead man’s switch)rejected
— Order rejected at placementtickRejected
— Rejected due to invalid tick priceminTradeNtlRejected
— Rejected due to minimum notional requirementperpMarginRejected
— Rejected due to insufficient marginreduceOnlyRejected
— Rejected due to reduce-only constraintsbadAloPxRejected
— Rejected due to post-only immediate matchiocCancelRejected
— IOC order rejected due to no immediate matchbadTriggerPxRejected
— Rejected due to invalid trigger pricemarketOrderNoLiquidityRejected
— Market order rejected due to insufficient liquiditypositionIncreaseAtOpenInterestCapRejected
— Rejected due to open interest cappositionFlipAtOpenInterestCapRejected
— Rejected due to position flip at OI captooAggressiveAtOpenInterestCapRejected
— Rejected due to aggressive pricing at OI capopenInterestIncreaseRejected
— Rejected due to open interest increase limitsinsufficientSpotBalanceRejected
— Rejected due to insufficient spot balanceoracleRejected
— Rejected due to price deviation from oracleperpMaxPositionRejected
— Rejected due to position size limitsopen
— Order still active (rare in historical data)Gtc
— Good Till Canceled (remains active until filled or canceled)Ioc
— Immediate Or Cancel (execute immediately or cancel)Fok
— Fill Or Kill (execute completely or cancel)FrontendMarket
— Market order placed through frontend interfaceinfo
endpoint with type: "historicalOrders"
is essential for applications that need to:
Successful response with historical orders data
The response is of type object[]
.