Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "historicalOrders"
user*stringUser’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

FieldTypeDescription
order.coinstringAsset symbol
order.sidestring”B” for buy, “A” for sell
order.limitPxstringLimit price (null for market orders)
order.szstringRemaining size
order.oidnumberOrder ID
order.orderTypestringOrder type (limit, market, trigger)
order.timestampnumberOrder creation timestamp
order.origSzstringOriginal order size
order.triggerConditionstring | nullTrigger condition for trigger orders
order.isTriggerbooleanWhether this is a trigger order
order.triggerPxstringTrigger price (0 for non-trigger orders)
order.childrenarrayChild orders (for bracket orders)
order.isPositionTpslbooleanWhether this is a position TP/SL order
order.reduceOnlybooleanWhether order can only reduce position
order.tifstringTime in force (Gtc, Ioc, Alo, FrontendMarket, LiquidationMarket)
order.cloidstring | nullClient order ID
statusstringOrder status
statusTimestampnumberStatus 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)