Subscribe Transfer

Subscribe to real-time account transfer updates (deposits, withdrawals, transfers, fees, etc.) for GET account/transfers. Uses the Spacetime account_transfers table. Requires account and subaccount index.

Subscribe to account transfer updates (requires authentication, supports delegation)#

Channel:WEBSOCKET

Tag:

Account

subscribeTransferRequest#

MESSAGE

Request to subscribe to account transfer updates (requires authentication, supports delegation)

Parameters

sourcestring

Must be 'transfer'

accountstring

Ethereum address of the account (must match authenticated user or user must be a delegate)

subaccountIndexinteger

Subaccount index to subscribe to transfer updates for

Payload

{
  "jsonrpc": "2.0",
  "method": "subscribe",
  "params": {
    "source": "transfer",
    "account": "0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78",
    "subaccountIndex": 0
  },
  "id": 11
}

subscribeResponse#

Generic success response for subscription requests

Parameters

message?string

Success message

Payload

{
  "jsonrpc": "2.0",
  "result": {
    "message": "Subscribed to trades"
  },
  "usIn": 1234567890123,
  "usOut": 1234567890456,
  "usDiff": 333,
  "id": 2
}

transfer#

Real-time notification for a new account transfer (deposit, withdrawal, transfer, fee, etc.). Same shape as GET /account/transfers items. Wrapped with type field to identify the message type.

Parameters

transferTypestring

amountstring

Signed amount (positive = credit, negative = debit), fixed-point string

accountstring

Account address (hex)

subaccountIndexinteger

Subaccount index

counterpartyAccountstring

Counterparty account (zero address for external flows)

counterpartySubaccountIndexinteger

Counterparty subaccount index

timestampMillisinteger

Block timestamp in milliseconds since Unix epoch

symbolstring

Market symbol (e.g. ETH-USD-PERP)

Payload

{
  "type": "Transfer",
  "data": {
    "transferType": "Deposit",
    "amount": "1000.000000",
    "account": "0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78",
    "subaccountIndex": 0,
    "counterpartyAccount": "0x0000000000000000000000000000000000000000",
    "counterpartySubaccountIndex": 0,
    "timestampMillis": 1752846925000,
    "symbol": "ETH-USD-PERP"
  }
}

errorResponse#

Error response for failed requests

Parameters

jsonrpcstring

JSON-RPC version

errorobject

usIninteger

Request received timestamp in milliseconds

usOutinteger

Response sent timestamp in milliseconds

usDiffinteger

Processing time in milliseconds

id?string | integer | null

Request identifier (if provided in request, otherwise null)

Payload

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid subscription params"
  },
  "usIn": 1234567890123,
  "usOut": 1234567890456,
  "usDiff": 333,
  "id": 2
}