Overview

​

Use Cases

​

Quick Start

const ws = new WebSocket('wss://wss.predexon.com/v1/your_api_key');

ws.onopen = () => {
  ws.send(JSON.stringify({
    action: 'subscribe',
    platform: 'polymarket',
    version: 1,
    type: 'orders',
    filters: { users: ['0x1234...'] }
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === 'event') {
    console.log('Trade:', msg.data);
  }
};

​

Connection

​

Endpoint

wss://wss.predexon.com/v1/YOUR_API_KEY

{
  "type": "connected",
  "message": "Connected to Predexon WebSocket"
}

​

Connection Errors

​

Channels

​

Filter Availability by Channel

​

Plan Limits

​

Keepalive & Connection Management

• The server sends a WebSocket ping every 30 seconds. Your client must respond with a pong (most WebSocket libraries handle this automatically).
• If no pong is received within 60 seconds, the connection is closed.
• If a connection has zero active subscriptions for 2 minutes, it is closed with close code 4000.
• If the client is consuming events too slowly and the server-side outbound buffer exceeds 1 MB, new events will be dropped. If it exceeds 4 MB, the connection is terminated.

​

Error Handling

{
  "type": "error",
  "code": "ERROR_CODE",
  "message": "Human-readable error message"
}

​

Error Codes