User Data Stream

The user data stream pushes your private events, order updates and balance changes, the moment they happen, so you never poll your account.

1. Create a listen key

Returns a listenKey that identifies your private stream. It is valid for 60 minutes.

{ "listenKey": "aX9f2c...e01" }

2. Connect

wss://stream.spacedex.com/ws/<listenKey>

3. Keep it alive

Send a keepalive at least every 30 minutes to extend the listen key another 60 minutes. Delete it with DELETE when you are done.

Events

An executionReport arrives whenever one of your orders changes, and an outboundAccountPosition arrives whenever a balance changes.

{
  "e": "executionReport",
  "s": "BTCUSDT",
  "i": 288274,
  "S": "BUY",
  "X": "FILLED",
  "l": "0.01000000",
  "L": "64000.00",
  "n": "0.64",
  "N": "USDT",
  "T": 1717430400500
}