POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (openOrders)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "openOrders",
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "dex": ""
}'
[
  {
    "coin": "<string>",
    "limitPx": "<string>",
    "oid": 123,
    "side": "<string>",
    "sz": "<string>",
    "timestamp": 123
  }
]
The info endpoint with type: "openOrders" retrieves a user’s open orders for both perpetuals and spot trading on the Hyperliquid exchange. This endpoint provides essential information about all pending orders that have not yet been filled or canceled.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "openOrders" to retrieve user’s open orders.
  • user (string, required) — Address in 42-character hexadecimal format (e.g., 0x31ca8395cf837de08b24da3f660e77761dfb974b).
  • dex (string, optional) — Perp dex name. Defaults to the empty string which represents the first perp dex. Spot open orders are only included with the first perp dex.

​
Response

The response is an array of open order objects, each containing:

​
Order fields

  • coin (string) — Trading pair or asset symbol:
    • For perpetuals: Asset name (e.g., “BTC”, “ETH”)
    • For spot: Token symbol or index format (e.g., “PURR/USDC”, “@107”)
  • limitPx (string) — Limit price of the order in string format for precision
  • oid (integer) — Order ID, a unique identifier for the order
  • side (string) — Order side:
    • "A" — Ask (sell order)
    • "B" — Bid (buy order)
  • sz (string) — Remaining size of the order (unfilled amount)
  • timestamp (integer) — Order creation timestamp in milliseconds

​
Order side interpretation

  • “A” (Ask): Sell order - user wants to sell the asset at the specified price
  • “B” (Bid): Buy order - user wants to buy the asset at the specified price

​
Asset naming conventions

  • Perpetuals: Use simple asset names like “BTC”, “ETH”
  • Spot: Use either pair format like “PURR/USDC” or index format like “@107”

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "openOrders", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

​
Example response

[
  {
    "coin": "BTC",
    "limitPx": "29792.0",
    "oid": 91490942,
    "side": "A",
    "sz": "0.0",
    "timestamp": 1681247412573
  }
]

​
Use case

The info endpoint with type: "openOrders" is essential for trading applications that need to:
  • Display user’s current open orders in a trading interface
  • Calculate total order exposure and risk management
  • Implement order management features (cancel, modify)
  • Show pending orders across both perpetuals and spot markets
  • Track order status and remaining unfilled quantities
  • Build comprehensive trading dashboards
  • Monitor liquidity provision through open limit orders
  • Implement automated trading strategies that need order awareness
This endpoint is typically called frequently to keep trading interfaces updated with the current state of all pending orders, enabling users to manage their trading positions effectively.

Body

application/json
​
type
enum<string>
default:openOrders
required

Request type to retrieve user's open orders

Available options:
openOrders
​
user
string
default:0x31ca8395cf837de08b24da3f660e77761dfb974b
required

Address in 42-character hexadecimal format

​
dex
string
default:""

Perp dex name. Defaults to empty string which represents the first perp dex. Spot open orders are only included with the first perp dex

Response

200 - application/json

Array of user's open orders

List of open orders for the user

​
coin
string
required

Trading pair or asset symbol (e.g., 'BTC', 'ETH', '@107' for spot)

​
limitPx
string
required

Limit price of the order

​
oid
integer
required

Order ID - unique identifier for the order

​
side
string
required

Order side: 'A' for ask (sell), 'B' for bid (buy)

​
sz
string
required

Remaining size of the order (unfilled amount)

​
timestamp
integer
required

Order creation timestamp in milliseconds