Order Updates

Real-time order status change notifications

Overview

Subscribe to orderUpdates to receive real-time notifications when your order status changes.

Subscribe

Request Body

Parameter	Type	Description
method*	string	Must be "subscribe"
subscription*	object	See below
subscription.type*	string	Must be "orderUpdates"
subscription.user*	string	Your wallet address (lowercase), e.g., "0x742d35cc6634c0532925a3b844bc9e7595f0beb"

Response

Subscription Confirmation:

{
  "channel": "subscriptionResponse",
  "data": {
    "method": "subscribe",
    "subscription": {
      "type": "orderUpdates",
      "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb"
    }
  }
}

Initial Snapshot:

{
  "channel": "orderUpdates",
  "data": {
    "isSnapshot": true,
    "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
    "orders": [
      {
        "order": {
          "coin": "BTC",
          "side": "B",
          "limitPx": "50000.00",
          "sz": "0.1",
          "oid": "0x1234567890abcdef...",
          "venueOid": 12345,
          "timestamp": 1701234567890,
          "origSz": "0.1"
        },
        "status": "open",
        "statusTimestamp": 1701234567890
      }
    ]
  }
}

Status Update:

{
  "channel": "orderUpdates",
  "data": {
    "isSnapshot": false,
    "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
    "orders": [
      {
        "order": {
          "coin": "BTC",
          "side": "B",
          "limitPx": "50000.00",
          "sz": "0.05",
          "oid": "0x1234567890abcdef...",
          "venueOid": 12345,
          "timestamp": 1701234567890,
          "origSz": "0.1"
        },
        "status": "partial",
        "statusTimestamp": 1701234570000
      }
    ]
  }
}

Order Fields

Field	Type	Description
coin	string	Asset symbol (BTC, ETH, etc.)
side	string	"B" (buy) or "A" (ask/sell)
limitPx	string	Limit price
sz	string	Current order size (decreases as filled)
oid	string	Order ID (128-bit hex string)
venueOid	number	Venue order ID (assigned when accepted)
timestamp	number	Order creation time in milliseconds
origSz	string	Original order size

Status Fields

Field	Type	Description
status	string	Current order status (see table below)
statusTimestamp	number	Time of last status change

Order Status Values

Status	Description
pending	Order placed, awaiting venue acceptance
open	Order accepted by venue, not yet filled
partial	Order partially filled
filled	Order completely filled
canceled	Order canceled (user or system initiated)
rejected	Order rejected by venue

Unsubscribe

{
  "method": "unsubscribe",
  "subscription": {
    "type": "orderUpdates",
    "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb"
  }
}

Notes

• isSnapshot: true sent immediately with all open/partial orders
• isSnapshot: false for real-time updates
• User address must be lowercase
• sz decreases as order fills, origSz stays constant