Messages

{
  "type": "subscribed",
  "channel": "accountTransferUpdates",
  "id": "0xAbCd...1234",
  "contents": {
    "isSnapshot": true,
    "accountTransferEvents": [
      {
        "type": "DEPOSIT",
        "eventId": "dep-abc123",
        "amount": "100.00",
        "netQuoteBalance": "1234.56",
        "globalSequenceId": 9600000001,
        "accountSequenceNum": 42
      }
    ]
  }
}

{
  "type": "channel_data",
  "channel": "accountTransferUpdates",
  "id": "0xAbCd...1234",
  "contents": {
    "isSnapshot": false,
    "accountTransferEvents": [
      {
        "type": "WITHDRAWAL",
        "eventId": "wdl-xyz789",
        "amount": "250.00",
        "netQuoteBalance": "984.56",
        "globalSequenceId": 9600000002,
        "accountSequenceNum": 43
      }
    ]
  }
}

Account

Account transfer updates

Endpoint: wss://api.arcus.xyz/v1/ws — one socket multiplexes every channel and RPC request. Click Connect, then send the example subscribe message below to start receiving data.

Account transfer events (deposits, withdrawals, transfers, referral claims) for an account. Snapshot on subscribe contains the most recent events newest-first (isSnapshot: true); each streaming update carries a single event (isSnapshot: false) as it is applied by the engine.

Amounts and balances are human-readable decimal strings in quote currency. globalSequenceId gives strict ordering across all engine events. The equivalent REST read is GET /v1/accountTransferUpdates.

WSS

ws?channel=accountTransferUpdates

Messages

{
  "type": "subscribed",
  "channel": "accountTransferUpdates",
  "id": "0xAbCd...1234",
  "contents": {
    "isSnapshot": true,
    "accountTransferEvents": [
      {
        "type": "DEPOSIT",
        "eventId": "dep-abc123",
        "amount": "100.00",
        "netQuoteBalance": "1234.56",
        "globalSequenceId": 9600000001,
        "accountSequenceNum": 42
      }
    ]
  }
}

{
  "type": "channel_data",
  "channel": "accountTransferUpdates",
  "id": "0xAbCd...1234",
  "contents": {
    "isSnapshot": false,
    "accountTransferEvents": [
      {
        "type": "WITHDRAWAL",
        "eventId": "wdl-xyz789",
        "amount": "250.00",
        "netQuoteBalance": "984.56",
        "globalSequenceId": 9600000002,
        "accountSequenceNum": 43
      }
    ]
  }
}

Subscribe to an account channel

type:object

Account Transfer Updates Snapshot

Recent account transfer events for the account, newest-first, sent once on subscribe (isSnapshot: true). accountTransferEvents is empty when the account has no recent events.

Account Transfer Update

A single applied transfer event (isSnapshot: false, one entry in accountTransferEvents), emitted as each deposit / withdrawal / transfer is applied by the engine.

API documentation

Endpoints

WebSocket

Changelog

Account transfer updates