Historical Orders

Endpoint

POST /info

Request Body

Parameter	Type	Description
type*	string	Must be "historicalOrders"
user*	string	User’s wallet address (case-insensitive), e.g., "0x1234567890abcdef..."

Response

[
  {
    "order": {
      "coin": "BTC",
      "side": "B",
      "limitPx": "50000.00",
      "sz": "0.1",
      "oid": 12345,
      "orderType": "limit",
      "timestamp": 1701234567890,
      "origSz": "0.1",
      "triggerCondition": null,
      "isTrigger": false,
      "triggerPx": "0",
      "children": [],
      "isPositionTpsl": false,
      "reduceOnly": false,
      "tif": "Gtc",
      "cloid": "0x1234abcd..."
    },
    "status": "filled",
    "statusTimestamp": 1701234670000
  }
]

Response Fields

Field	Type	Description
order.coin	string	Asset symbol
order.side	string	”B” for buy, “A” for sell
order.limitPx	string	Limit price (null for market orders)
order.sz	string	Remaining size
order.oid	number	Order ID
order.orderType	string	Order type (limit, market, trigger)
order.timestamp	number	Order creation timestamp
order.origSz	string	Original order size
order.triggerCondition	string | null	Trigger condition for trigger orders
order.isTrigger	boolean	Whether this is a trigger order
order.triggerPx	string	Trigger price (0 for non-trigger orders)
order.children	array	Child orders (for bracket orders)
order.isPositionTpsl	boolean	Whether this is a position TP/SL order
order.reduceOnly	boolean	Whether order can only reduce position
order.tif	string	Time in force (Gtc, Ioc, Alo, FrontendMarket, LiquidationMarket)
order.cloid	string | null	Client order ID
status	string	Order status
statusTimestamp	number	Status update timestamp

Example Request

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

Error Responses

{
  "error": "Missing 'user' parameter for historical orders"
}

HTTP Status: 400 Bad Request

Notes

• Orders returned in reverse chronological order (newest first)
• Status values: "open", "filled", "canceled", "rejected"
• Filled orders show sz: "0" (remaining size is zero)