Balance Updates

Initial balance snapshot and live balance delta events

Use this stream for private balance snapshots and live balance changes.

Endpoint

wss://wallet-mutator-view.outpoll.com/balance/ws

Authentication

Send this message right after connect.

{
  "t": "AUTH",
  "d": {
    "apiKey": "<API_KEY>",
    "signature": "<SIGNATURE>",
    "timestamp": "<UNIX_EPOCH_SECONDS>"
  }
}

Build signature from timestamp + "GET" + "/balance/ws".

Initial snapshot

After auth, the server sends the current balances:

{
  "t": "success",
  "d": {
    "l": [
      {
        "i": "078dcd98-928d-479f-8110-ff6d27e44de2",
        "b": 1250.50,
        "f": 1200.00
      }
    ]
  },
  "r": null
}

Field	Type	Description
d.l[].i	string	Asset ID
d.l[].b	number	Balance
d.l[].f	number	Free balance

Balance delta

{
  "u": "user-id",
  "a": "asset-id",
  "aop": 0.50,
  "c": 50.00,
  "b": 1200.50,
  "f": 1150.00
}

Field	Type	Description
u	string	User ID
a	string	Asset ID
aop	number	Average open price
c	number	Cost
b	number	Balance
f	number	Free balance

Python example

balance_updates.py

import asyncio, json, websockets

def auth_message(api_key, signature, timestamp):
    return {
        "t": "AUTH",
        "d": {
            "apiKey": api_key,
            "signature": signature,
            "timestamp": timestamp,
        },
    }

async def balance_updates(api_key, signature, timestamp):
    uri = "wss://wallet-mutator-view.outpoll.com/balance/ws"
    async with websockets.connect(uri) as ws:
        await ws.send(json.dumps(auth_message(api_key, signature, timestamp)))

        async for msg in ws:
            print(json.loads(msg))