User Fills

Real-time trade execution updates

Overview

Subscribe to userFills to receive real-time notifications when your orders are executed (filled).

Subscribe

Request Body

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

Response

Subscription Confirmation:

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

Fill Updates:

{
  "channel": "userFills",
  "data": {
    "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
    "isSnapshot": false,
    "fills": [
      {
        "coin": "BTC",
        "px": "50000.00",
        "sz": "0.1",
        "side": "B",
        "time": 1701234567890,
        "startPosition": "0",
        "dir": "Open Long",
        "closedPnl": "0",
        "hash": "0x1234...",
        "oid": 12345,
        "crossed": true,
        "fee": "2.50",
        "tid": 67890,
        "feeToken": "USDC"
      }
    ]
  }
}

Fill Fields

Field	Type	Description
coin	string	Asset symbol (BTC, ETH, etc.)
px	string	Execution price
sz	string	Fill size
side	string	"B" (buy) or "A" (ask/sell)
time	number	Timestamp in milliseconds
startPosition	string	Position size before fill
dir	string	Direction (e.g., “Open Long”, “Close Short”)
closedPnl	string	Realized PnL from this fill
hash	string	Transaction hash
oid	number	Order ID
crossed	boolean	Whether order crossed the spread
fee	string	Fee charged
tid	number	Trade ID
feeToken	string	Token used for fee payment

Unsubscribe

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

Notes

• Fills are sent in real-time as they occur
• Multiple fills may arrive in a single message
• User address must be lowercase
• closedPnl shows realized profit/loss for position-reducing fills