> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# openOrders | Hyperliquid Info API

> Hyperliquid openOrders: list a user's resting open orders.

> [card] Credit Cost
>
> 1 per call

> [card] Processing
>
> Realtime

The Hyperliquid info endpoint with `type: "openOrders"` is used to list a user's resting open orders.

> [!TIP]
>
> Estimate your monthly cost for this API using the [Pricing Calculator](https://goldrush.dev/docs/pricing-calculator.md?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Fopen-orders).

> [!NOTE]
>
> * Wire-equal to `POST api.hyperliquid.xyz/info` with `{"type": "openOrders", "user": "..."}`.
> * For orders enriched with trigger metadata, TP/SL flags, and the human-readable order type shown in the Hyperliquid web UI, use [`frontendOpenOrders`](https://goldrush.dev/docs/api-reference/hyperliquid-info/frontend-open-orders) instead.
> * The optional `dex` field scopes the query to a HIP-3 builder DEX; the empty string (default) returns orders on the canonical Hyperliquid perp DEX.
> * For a real-time stream of order placement and cancellation events, subscribe to [`walletTxs`](https://goldrush.dev/docs/goldrush-hyperliquid/streaming/wallet-firehose).

Returns a single user's currently resting open orders as compact rows: coin, side, limit price, remaining size, order id, placement timestamp, original size, and client order id. This is the lightweight variant - reach for frontendOpenOrders when you also need trigger conditions, reduce-only / position-TP-SL flags, and the human-readable order type.

## Endpoint

```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
```

## Request

**type** `string` *required*

Always `"openOrders"`.

**user** `string` *required*

The wallet address (lowercase 0x-prefixed hex).

**dex** `string`

HIP-3 builder DEX identifier. Empty string (default) returns orders on the canonical Hyperliquid perp DEX.

### Example

```bash cURL theme={null}
curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "openOrders",
    "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
  }'
```

```typescript TypeScript theme={null}
const response = await fetch("https://hypercore.goldrushdata.com/info", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "openOrders",
    user: "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
  }),
});

const orders = await response.json();
```

```python Python theme={null}
import os, requests

response = requests.post(
    "https://hypercore.goldrushdata.com/info",
    headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
    json={
        "type": "openOrders",
        "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
    },
)

orders = response.json()
```

## Response

An array of open-order objects. Empty when the user has no resting orders.

```json theme={null}
[
  {
    "coin": "UNI",
    "side": "B",
    "limitPx": "3.8558",
    "sz": "104.2",
    "oid": 501169923808,
    "timestamp": 1784799315550,
    "origSz": "104.2",
    "cloid": "0x00000000000000000000019f8ad9b4b4"
  }
]
```

### Field descriptions

> [!NOTE]
>
> `limitPx`, `sz`, and `origSz` are returned as **decimal strings**, preserving upstream precision. Do not parse them as floats.

**coin** `string`

Asset symbol - e.g. `"BTC"`, `"UNI"` for perps; spot pairs use the `@N` form.

**side** `string`

`"B"` for buy/long, `"A"` for ask/short.

**limitPx** `string`

Limit price.

**sz** `string`

Remaining (unfilled) order size.

**oid** `int`

Numeric order ID.

**timestamp** `int`

Order placement time in milliseconds since Unix epoch.

**origSz** `string`

Original order size before any partial fills.

**cloid** `string | null`

Client order ID set at placement, or `null` when none was provided.

## Related endpoints

> [card] [frontendOpenOrders](https://goldrush.dev/docs/api-reference/hyperliquid-info/frontend-open-orders.md)
>
> fetch a user's currently open orders enriched with frontend metadata.

> [card] [historicalOrders](https://goldrush.dev/docs/api-reference/hyperliquid-info/historical-orders.md)
>
> fetch a user's recent orders - both open and finalized - each with its current status and status timestamp.

> [card] [orderStatus](https://goldrush.dev/docs/api-reference/hyperliquid-info/order-status.md)
>
> look up the status of a single order for a user, by order id (oid) or client order id (cloid).

> [card] [perpsAtOpenInterestCap](https://goldrush.dev/docs/api-reference/hyperliquid-info/perps-at-open-interest-cap.md)
>
> list the perp assets currently at their open-interest cap.

See all Hyperliquid endpoints: [Overview hub](https://goldrush.dev/docs/goldrush-hyperliquid/overview.md) · [Info API reference](https://goldrush.dev/docs/goldrush-hyperliquid/info-api/overview.md)

*Last reviewed: 2026-08-17*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.