Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "openOrders"
user*stringUser’s wallet address (case-insensitive), e.g., "0x1234567890abcdef..."

​
Response

[
  {
    "coin": "BTC",
    "isPositionTpsl": false,
    "isTrigger": false,
    "limitPx": "49000.00",
    "oid": "0x1a2b3c4d5e6f7890...",
    "venueOid": 12345,
    "orderType": "limit",
    "origSz": "0.1",
    "reduceOnly": false,
    "side": "B",
    "sz": "0.1",
    "timestamp": 1701234567890,
    "triggerCondition": "",
    "triggerPx": "0"
  }
]

​
Response Fields

FieldTypeDescription
coinstringAsset symbol (BTC, ETH, SOL, etc.)
isPositionTpslbooleanWhether order is a position TP/SL
isTriggerbooleanWhether order is a trigger order
limitPxstringLimit price (“0” for market orders)
oidstringInternal order ID (128-bit hex string)
venueOidnumberHyperLiquid’s numeric order ID (required for cancellation)
orderTypestringOrder type: "limit", "market", "stop_limit", "stop_market"
origSzstringOriginal order size
reduceOnlybooleanWhether order is reduce-only
sidestring”B” for buy, “A” for sell/ask
szstringRemaining order size
timestampnumberOrder creation timestamp (ms)
triggerConditionstringTrigger condition for trigger orders: "tp" (take profit) or "sl" (stop loss)
triggerPxstringTrigger price (only for trigger orders)

​
Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "openOrders",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }'

​
Error Responses

{
  "error": "Missing 'user' parameter for open orders"
}
HTTP Status: 400 Bad Request

​
Notes

  • Only returns orders with status “pending”, “open”, or “partial”
  • The venueOid is required for order cancellation
  • Partially filled orders show remaining size in sz, original in origSz
  • Results are sorted by timestamp (newest first)