Skip to main content
POST
historicalOrders | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "historicalOrders" is used to fetch a user’s recent orders - both open and finalized - each with its current status and status timestamp.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "historicalOrders", "user": "0x..."}.
  • Returns the user’s most recent orders across every coin, open and finalized (filled, canceled, and other terminal states). For only the currently-resting orders, use openOrders or frontendOpenOrders.
  • limit caps the number returned; the default and maximum is 2000.
Returns an array of the user’s recent orders, newest-relevant first, each wrapped with the order’s terminal-or-current status and the millisecond timestamp that status was set. Use it to reconstruct recent order history, audit fills/cancels, or drive an activity view.

Endpoint

Request

string
default:"historicalOrders"
required
Always "historicalOrders".
string
required
The account address in 42-character hex format, e.g. "0x0000000000000000000000000000000000000000".
int
Maximum number of orders to return. Defaults to 2000; values above 2000 are capped at 2000.

Example

Response

An array of order entries. Each element pairs the order with its status and the millisecond timestamp that status took effect.

Field descriptions

limitPx, sz, origSz, and triggerPx are returned as decimal strings, preserving upstream precision. Do not parse them as floats.
array<object>
One entry per order.

orderStatus

Look up the status of a single order by oid or cloid.

openOrders

A user’s currently-resting open orders.

frontendOpenOrders

Open orders with additional frontend fields.

userFills

A user’s recent fills.