Real-time data

Synthesis provides three WebSocket endpoints for real-time updates. All connections use the same pattern: connect, subscribe, receive initial state, then receive live updates.

Balance

Stream wallet balances, order fills, and position changes in real-time.

Orderbook

Live orderbook snapshots and delta updates for prediction markets.

Trades

Real-time trade executions, volume tracking, and whale alerts.

Connection basics

All WebSocket connections follow the same pattern:

const ws = new WebSocket("wss://synthesis.trade/ws/{endpoint}");

ws.onopen = () => {
    ws.send(JSON.stringify({
        type: "subscribe",
        // ... subscription parameters
    }));
};

ws.onmessage = (event) => {
    const data = JSON.parse(event.data);
    if (data.success) {
        console.log(data.response);
    }
};

The server sends ping frames every 30 seconds to keep connections alive. Your client should respond with pong frames automatically (most WebSocket libraries handle this).

Endpoints

Endpoint	Max Subscriptions	Description
`wss://synthesis.trade/ws/balance`	500 wallets	Wallet balances and order status
`wss://synthesis.trade/ws/orderbook`	5,000 markets	Orderbook snapshots and deltas
`wss://synthesis.trade/ws/trades`	1,000 markets	Trade executions

Overview

Getting Started

Authentication

Real-time data

Balance

Orderbook

Trades

Connection basics

Endpoints

Balance

Orderbook

Trades

​Connection basics

​Endpoints

Connection basics

Endpoints