Skip to main content

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.

Returns a single user’s currently open orders, enriched with the frontend-only metadata the Hyperliquid web UI uses: TP/SL trigger info, whether the order is a position-level TP/SL, reduce-only flag, and the human-readable order type. User-keyed. Updated on every order placement, cancellation, or fill.

​
Endpoint

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

​
Request

​
type
string
required
Always "frontendOpenOrders".
​
user
string
required
The wallet address (lowercase 0x-prefixed hex).
​
dex
string
HIP-3 builder DEX identifier. Empty string returns orders on the canonical Hyperliquid perp DEX.

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "frontendOpenOrders",
    "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
    "dex": ""
  }'

​
Response

An array of open orders. Each order object includes the standard openOrders fields plus the frontend* enrichment fields. 
[
  {
    "coin": "ETH",
    "side": "B",
    "limitPx": "3300.0",
    "sz": "0.5",
    "oid": 95012345,
    "timestamp": 1735689600000,
    "triggerCondition": "N/A",
    "isTrigger": false,
    "triggerPx": "0.0",
    "children": [],
    "isPositionTpsl": false,
    "reduceOnly": false,
    "orderType": "Limit",
    "origSz": "0.5",
    "tif": "Gtc",
    "cloid": null
  },
  {
    "coin": "ETH",
    "side": "A",
    "limitPx": "3800.0",
    "sz": "2.5",
    "oid": 95012346,
    "timestamp": 1735689700000,
    "triggerCondition": "Mark price >= 3800.0",
    "isTrigger": true,
    "triggerPx": "3800.0",
    "children": [],
    "isPositionTpsl": true,
    "reduceOnly": true,
    "orderType": "Take Profit Market",
    "origSz": "2.5",
    "tif": null,
    "cloid": null
  }
]

​
Field descriptions

​
coin
string
Asset symbol.
​
side
string
"B" for buy/long, "A" for ask/short.
​
limitPx
string
Limit price.
​
sz
string
Remaining order size.
​
oid
int
Numeric order ID.
​
timestamp
int
Order placement time in milliseconds since Unix epoch.
​
triggerCondition
string
Human-readable trigger condition. "N/A" for non-trigger orders.
​
isTrigger
boolean
true for stop-loss, take-profit, and other conditional orders.
​
triggerPx
string
Trigger price for conditional orders. "0.0" for limits.
​
children
array<object>
Child orders attached to this parent (e.g. bracket orders).
​
isPositionTpsl
boolean
true if this is a position-level TP/SL (closes the entire position when triggered).
​
reduceOnly
boolean
true if this order can only reduce, not increase, position size.
​
orderType
string
Human-readable order type - "Limit", "Take Profit Market", "Stop Limit", etc.
​
origSz
string
Original order size before any partial fills.
​
tif
string
Time-in-force - "Gtc", "Ioc", "Alo", or null for trigger orders.
​
cloid
string
Client order ID (null if not provided at placement).

​
Notes

  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "frontendOpenOrders", "user": "..."}.
  • Use frontendOpenOrders instead of openOrders when you need the trigger metadata and human-readable order type - exactly what the Hyperliquid web UI displays.
  • For a real-time stream of order placement and cancellation events, subscribe to walletTxs.