Pfun Real-Time WebSocket

Connect to the Pfun WebSocket for real-time price, orderbook, and trade updates. --- Connection: Connect to the WebSocket endpoint: Connect to: wss://api.delphiterminal.co/ws/pfun --- Subscribing to Markets: Once connected, send a JSON message to subscribe to Pfun data using their `market_id`: { "action": "subscribe", "market_ids": ["market123", "market456"], "message_types": ["prices", "orderbook", "trades"] } Subscription Fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | action | string | Yes | `subscribe` or `unsubscribe` | | market_ids | array | Yes | Array of Pfun market identifiers | | message_types | array | No | `["prices"]`, `["orderbook"]`, `["trades"]`, or any combination. Defaults to prices and orderbook if omitted | --- Unsubscribing: { "action": "unsubscribe", "market_ids": ["market123"] } --- Message Types: Price Messages: Real-time price updates for subscribed markets: { "type": "prices", "data": { "exchange": "pfun", "market_id": "market123", "price": 0.65, "yes_bid": 0.64, "yes_ask": 0.66, "last_update": "2026-02-06T12:00:00Z" } } Orderbook Messages: Real-time orderbook snapshots for subscribed markets: { "type": "orderbook", "data": { "exchange": "pfun", "market_id": "market123", "venue_market_id": "venue123", "best_yes_price": 65, "best_yes_size": 100, "best_no_price": 35, "best_no_size": 50, "yes_side": [100, 200, 300], "no_side": [50, 100, 150], "server_time": "2026-02-06T12:00:00Z" } } Trade Messages: Real-time trade executions for subscribed markets: { "type": "trades", "data": { "exchange": "pfun", "market_id": "market123", "yes_price": 0.65, "no_price": 0.35, "count": 10, "taker_side": "buy", "last_update": "2026-02-06T12:00:00Z" } } --- Full JavaScript Example: Connect to: wss://api.delphiterminal.co/ws/pfun ws.onopen = () => { console.log('Connected to Pfun WebSocket // Subscribe to markets ws.send(JSON.stringify({ action: 'subscribe', market_ids: ['market123'], message_types: ['prices', 'orderbook', 'trades'] })); }; ws.onmessage = (event) => { const data = JSON.parse(event.data); if (data.type === 'prices') { console.log('Price update:', data.data); } else if (data.type === 'orderbook') { console.log('Orderbook update:', data.data); } else if (data.type === 'trades') { console.log('Trade:', data.data); } }; ws.onclose = () => { console.log('Disconnected from WebSocket }; ws.onerror = (error) => { console.error('WebSocket error:', error); }; --- Connection Details: | Property | Value | |----------|-------| | Protocol | WebSocket (wss://) | | Keepalive | Ping every 54 seconds | | Timeout | 60 seconds without pong | | Max Message Size | 16 KB | --- Notes: - **No authentication required** for WebSocket connection - You must use `market_id` (Pfun market identifier) to subscribe - Messages are only sent for markets you have explicitly subscribed to - Multiple markets can be subscribed in a single message - Subscribe to specific message types to reduce message volume - Trades must be explicitly requested (not included in default subscription) ## Example - Request: `GET /ws/pfun` - Header: `X-API-Key: YOUR_API_KEY`