Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.synthesis.trade/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

EndpointMax SubscriptionsDescription
wss://synthesis.trade/ws/balance500 walletsWallet balances and order status
wss://synthesis.trade/ws/orderbook5,000 marketsOrderbook snapshots and deltas
wss://synthesis.trade/ws/trades1,000 marketsTrade executions