User Transactions

Subscribe

Request Body

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

Response

Subscription Confirmation:

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

Transaction Notification:

{
  "channel": "userTransactions",
  "data": {
    "user": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
    "transaction": {
      "transactionId": "0x1234...",
      "type": "OrderPlaced",
      "timestamp": 1701234567890,
      "blockNumber": 12345,
      "txIndex": 0,
      "orderId": "0x5678...",
      "data": {}
    }
  }
}

Transaction Fields

Field	Type	Description
transactionId	string	Unique transaction hash
type	string	Transaction type (see table below)
timestamp	number	Transaction time in milliseconds
blockNumber	number	Block containing transaction
txIndex	number	Transaction index within block
orderId	string	Related order ID (if applicable)
data	object	Type-specific transaction data

Transaction Types

Type	Description
OrderPlaced	New order submitted
OrderCanceled	Order canceled by user
OrderFilled	Order executed (partial or complete)
Deposit	Funds deposited to account
Withdrawal	Funds withdrawn from account
Transfer	Internal transfer between accounts
FundingPayment	Funding rate payment
InterestPayment	Interest charged on borrowed funds
Liquidation	Position liquidated
PositionModified	Position take-profit/stop-loss updated

Type-Specific Data

OrderPlaced

{
  "type": "OrderPlaced",
  "orderId": "0x5678...",
  "data": {
    "coin": "BTC",
    "side": "B",
    "limitPx": "50000.00",
    "sz": "0.1"
  }
}

OrderFilled

{
  "type": "OrderFilled",
  "orderId": "0x5678...",
  "data": {
    "coin": "BTC",
    "filledSz": "0.05",
    "avgPx": "50000.00",
    "fee": "2.50"
  }
}

Deposit

{
  "type": "Deposit",
  "data": {
    "asset": "USDC",
    "amount": "1000.00",
    "txHash": "0xabcd..."
  }
}

Withdrawal

{
  "type": "Withdrawal",
  "data": {
    "asset": "USDC",
    "amount": "500.00",
    "destination": "0x9876...",
    "txHash": "0xefgh..."
  }
}

FundingPayment

{
  "type": "FundingPayment",
  "data": {
    "coin": "BTC",
    "amount": "-1.25",
    "rate": "0.0001"
  }
}

Unsubscribe

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

Notes

• Transactions sent in real-time as they occur
• User address must be lowercase
• Transaction data structure varies by type